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.

Vigencia del token
Los tokens expiran en 30 minutos y solo sirven para una transacción (incluso si la transacción salió mal). Cuando expire, debes solicitar uno nuevo.

🇨🇴 Colombia — flujo Bre-B (pagos con QR en tiempo real)

Envía flowType: "BRE_B" para procesar la transacción por Bre-B en vez de ACH. Solo amount,
currency y flowType son obligatorios: bankId, callbackUrl, userType, documentType,
documentNumber, paymentDescription y email pasan a ser opcionales.

No necesitas llamar antes a Get Bank List: el cliente autoriza el pago
escaneando un QR en su app bancaria en vez de elegir un banco.

Bre-B requiere el procesador habilitado en tu MID: contacta a tu ejecutivo de cuenta para activarlo.
El flujo ACH (sin flowType) no cambia.

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 'https://api-uat.kushkipagos.com/transfer/v1/tokens' \
--header 'Public-Merchant-Id: 20432ef8ccd94r51b36e5b738a81f511' \
--header 'Content-Type: application/json' \
--data-raw '{
    "bankId": "1022",
    "amount": {
        "subtotalIva": 100000,
        "subtotalIva0": 0,
        "iva": 10000,
        "extraTaxes": {
            "tasaAeroportuaria": 0,
            "agenciaDeViajes": 0,
            "iac": 0
        }
    },
    "callbackUrl": "https://kushki.com",
    "userType": "1",
    "documentType": "NIT",
    "documentNumber": "1716458334",
    "paymentDescription": "Description of the payment.",
    "email": "user@example.com",
    "currency": "COP"
}'

Response Example

201 - application/json

{
    "token": "V0OzRB100000xhxQB8035251pHLBQsq5"
}

Modified at 2026-09-11 15:05:20

Consultar lista de bancos

Iniciar transacción

Solicitar un token de Transfer In

Vigencia del token#

Request

Responses

Vigencia del token