Create a payment button

POST

/smartlink/v1/webcheckout

Create a URL to redirect your user to a Kushki webcheckout.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200

application/json

Bodyapplication/json

🟠400

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api-uat.kushkipagos.com/smartlink/v1/webcheckout' \
--header 'Private-Merchant-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "kind": "webcheckout",
    "contactDetail": {
        "email": "tucliente@test.com",
        "name": "Tu cliente"
    },
    "redirectURL": "https://www.tucomercio.com",
    "products": [
        {
            "description": "Tenis",
            "name": "trekking pro",
            "quantity": 20,
            "unitPrice": 1000
        }
    ],
    "paymentConfig": {
        "amount": {
            "subtotalIva0": 10,
            "currency": "USD",
            "iva": 2,
            "subtotalIva": 2
        },
        "paymentMethod": [
            "credit-card",
            "cash",
            "transfer"
        ]
    },
    "additionalInformation": {}
}'

Response Example

200 - example-1

{
    "webcheckoutId": "T3iDy0G4I",
    "webcheckoutUrl": "https://webcheckout-qa.kushkipagos.net/webcheckout/T3iDy0G4E"
}

Modified at 2026-07-10 20:38:28

Payment Button

Settlement