Solicitar un token de Transfer In

https://api-uat.kushkipagos.com

POST

/transfer/v1/tokens

Un token de Transfer In te permite iniciar una transacción de Transfer In.

Expiración del token
Los tokens expiran en 30 minutos y solo se pueden usar para una única transacción (incluso si la transacción fue errónea). Cuando expire, deberás solicitar un token nuevo.

Request

Header Params

Body Params application/json

Examples

Responses

🟢201Created

application/json

Bodyapplication/json

🟠400Bad Request

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location '/transfer/v1/tokens' \
--header 'Public-Merchant-Id;' \
--header 'Content-Type: application/json' \
--data '{
    "financialInstitutionCode": "12345678",
    "amount": {
        "subtotalIva": 100000,
        "subtotalIva0": 0,
        "iva": 10000,
        "ExtraTaxes": {
            "tasaAeroportuaria": 0,
            "agenciaDeViajes": 0,
            "iac": 0
        }
    },
    "callbackUrl": "http://www.mylanderpages.com/kushki/TestSold",
    "userType": "1",
    "referenceNumber": "NIT171054019",
    "paymentDescription": "Description of the payment."
}'

Response Example

201 - application/json

{
    "token": "V0OzRB100000xhxQB8035251pHLBQsq5"
}

Modified at 2026-09-11 14:57:58

Consultar lista de bancos

Iniciar transacción

Solicitar un token de Transfer In

Expiración del token#

Request

Responses

Expiración del token