Request a Transfer Out token
POST
/payouts/transfer/v1/tokens
token is the first step to start a transaction.WARNING
Colombia 🇨🇴 — Two transfer modes
Bank account (ACH): Use accountTypevaluesCCorCAalong withbankId,accountNumber,documentType,documentNumber, andname. Requires prior bank list consultation.Payment key (Bre-B): Use accountTypevaluesKI,KP,KE,KA, orKMalong withaccountNumber(in the format that matches the key type).documentType,documentNumber,bankId, andnameare optional. The response includes akeyResolutionobject with the recipient's key value and name, which must be shown to the user for confirmation before initializing the transaction. Maximum amount per transaction: equivalent to 1,000 UVT (Unidades de Valor Tributario, updated annually by the DIAN). Individual banks and users may set lower daily or per-transaction limits.
DANGER
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.
Got a suggestion on this documentation? Contact Us.
Request
Header Params
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api-uat.kushkipagos.com/payouts/transfer/v1/tokens' \
--header 'Public-Merchant-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
"documentType": "CC",
"documentNumber": "string",
"accountType": "CC",
"accountNumber": "string",
"bankId": "string",
"totalAmount": 0,
"currency": "COP",
"paymentDescription": "string",
"name": "string",
"mail": "string"
}'Response Response Example
201 - Example 1
{
"token": "string",
"keyResolution": {
"keyValue": "string",
"ownerName": "string"
}
}Modified at 2026-04-15 21:33:35