Request a Transfer In token

UAT Testing Env

https://api-uat.kushkipagos.com

POST

/transfer/v1/tokens

A Transfer In token will allow you to start a Transfer In transaction.

Token expiration
Tokens will expire in 30 minutes and can be used only for a single transaction (even if the transaction was wrong). You will need to request a new token when it expires.

🇨🇴 Colombia — Bre-B flow (real-time QR payments)

Send the flow object — "flow": { "processorName": "BRE-B", "type": "QR" } — to run the transaction through Bre-B instead of ACH. Only amount,
currency and flow are required — bankId, callbackUrl, userType, documentType,
documentNumber, paymentDescription and email become optional.

You do not need to call Get Bank List first: the customer authorizes the payment by
scanning a QR in their banking app instead of choosing a bank.

Bre-B requires the processor enabled on your MID — contact your account executive to activate it.
The ACH flow (no flow object) is unchanged.

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

ACH — bank redirect (default)Bre-B — QR

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-18 21:10:10

Get Bank List

Init Transaction

Request a Transfer In token

Token expiration#

Request

Responses

Token expiration