Kushki Developer Portal
  1. PAYMENT BUTTON
Kushki Developer Portal
  • Back to home
  • Ecuador 🇪🇨
  • Bienvenidos
  • ONLINE PAYMENTS
    • CARD
      • 1. Request a card token
      • 2. Make a charge or deferred charge
      • 3. Void a transaction
      • 4. Refund a transaction
      • 5. Request deferred options
      • 6. Bin Info
      • 7. Bin Info V2
      • 8. Validate OTP
      • 7. Bin Info V2
      • 1. Request a card token
      • 4. Refund a transaction
      • 8. Validate OTP
      • 3. Void a transaction
      • 2. Make a charge or deferred charge
      • 5. Request deferred options
      • 6. Bin Info
    • ONE-CLICK & SCHEDULED PAYMENTS
      • 1. Request a recurring charge token
      • 2. Create a recurring charge
      • 3. Update recurring charge card data
      • 4. Make an One-click payment
      • 5. Cancel a recurring charge
      • 6. Update a recurring charge
      • 7. Add a temporary charge or discount
      • 8. Get recurring charge Info
      • 7. Add a temporary charge or discount
      • 4. Make an One-click payment
      • 3. Update recurring charge card data
      • 6. Update a recurring charge
      • 5. Cancel a recurring charge
      • 1. Request a recurring charge token
      • 8. Get recurring charge Info
      • 2. Create a recurring charge
    • TRANSFER IN
      • 1. Get Bank List
      • 2. Request a Transfer In token
      • 3. Init Transaction
      • 4. Get Status
      • 4. Get Status
      • 2. Request a Transfer In token
      • 3. Init Transaction
      • 1. Get Bank List
    • CASH IN
      • 1. Request a cash in token
      • 2. Init Transaction
      • 3. Transaction Status
      • 4. Update a cash in transaction
      • 5. Delete a cash in transaction
      • 1. Request a cash in token
      • 3. Transaction Status
      • 5. Delete a cash in transaction
      • 2. Init Transaction
      • 4. Update a cash in transaction
    • SMARTLINKS V2
      • 1. Create a Smartlink
      • 2. Get a Smartlink
      • 3. Delete a Smartlink
      • 4. Update a Smartlink
      • 3. Delete a Smartlink
      • 1. Create a Smartlink
      • 2. Get a Smartlink
      • 4. Update a Smartlink
    • ANALYTICS
      • 1. Get transactions list
      • 1. Get transactions list
    • GATEWAY STATUS
      • 1. Get gateway status
      • 1. Get gateway status
    • COMMISSIONS
      • 1. Get Commission Configuration
      • 1. Get Commission Configuration
    • PAYMENT CREDENTIALS
      • 1. Create a credential
      • 2. Search credentials
      • 3. Advanced search
      • 4. Activate or deactivate
      • 5. Delete credential
      • 6. Update credential
      • 7. Regenerate a credential
      • 1. Create a credential
      • 7. Regenerate a credential
      • 3. Advanced search
      • 6. Update credential
      • 5. Delete credential
      • 4. Activate or deactivate
      • 2. Search credentials
    • PAYMENT BUTTON
      • 1. Create a payment button
        POST
      • 1. Create a payment button
        POST
  1. PAYMENT BUTTON

1. Create a payment button

POST
/smartlink/v1/webcheckout

Request

Header Params

Body Params application/json

Examples

Responses

🔴500
application/json
Body

🟠400
🟢201
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/smartlink/v1/webcheckout' \
--header 'Private-Merchant-Id: {{EC-Private-Merchant-Id}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "kind": "webcheckout",
    "contactDetail": {
        "name": "John Doe",
        "email": "user@example.com"
    },
    "redirectURL": "https://www.kushki.com",
    "products": [
        {
            "description": "Tenis",
            "name": "runners",
            "quantity": 2,
            "unitPrice": 5000
        }
    ],
    "paymentConfig": {
        "amount": {
            "subtotalIva": 0,
            "subtotalIva0": 10000,
            "iva": 0,
            "currency": "USD"
        },
        "paymentMethod": "credit-card"
    },
    "additionalInformation": {
        "address": "centro 123"
    }
}'
Response Response Example
500 - 500 - An unexpected error has occurred
{
    "code": "WCH002",
    "message": "Ha ocurrido un error inesperado."
}
Modified at 2026-01-06 19:33:02
Previous
2. Search credentials
Next
1. Create a payment button
Built with