Init Transaction

UAT Testing Env

https://api-uat.kushkipagos.com

POST

/transfer/v1/init

Init the transaction with a Transfer In token provided by Kushki which represents the customer's payment.

🇨🇴 Colombia — Bre-B flow

When the token was created with flowType: "BRE_B", the response carries a qr field instead
of redirectUrl: there is no bank redirect. Render the QR for the customer to scan with their
banking app.

The QR expires in 10 minutes. After that, request a new token and call this endpoint again.
To invalidate an active QR earlier, use Cancel Transaction (PATCH /transfer/v1/cancel/{token}).

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/init' \
--header 'Private-Merchant-Id: 68sc9a1d38824acbb78b5bdd1fa3773d' \
--header 'Content-Type: application/json' \
--data '{
    "token": "string",
    "amount": {
        "subtotalIva": 0,
        "subtotalIva0": 0,
        "iva": 0,
        "extraTaxes": {
            "iac": 0,
            "tasaAeroportuaria": 0,
            "agenciaDeViaje": 0
        }
    },
    "contactDetails": {
        "fullName": "string",
        "address": "string",
        "phoneNumber": "3123456789",
        "email": "string"
    },
    "metadata": {
        "key0": "value0",
        "key1": "value1",
        "key2": "value2"
    },
    "fullResponse": "v2",
    "webhooks": {
        "webhooks": [
            {
                "events": [
                    "approvedTransaction",
                    "declinedTransaction"
                ],
                "headers": [
                    {
                        "label": "json",
                        "value": "12"
                    }
                ],
                "urls": [
                    "https://eof2hhkrta4ooo1.m.pipedream.net"
                ]
            }
        ]
    }
}'

Response Example

201 - Colombia

{
    "redirectUrl": "https://api-uat.kushkipagos.com/transfer/v1/agent?token=1e26fb158957ba72cea16f9f56e3507e&mid=60000000029523491241151620414038",
    "trazabilityCode": "1398429",
    "bankId": "1022",
    "bankName": "BANCO UNION COLOMBIANO",
    "transactionReference": "aef8884f-cd4d-4b9b-9efa-ad582629e4f2"
}

Modified at 2026-08-25 13:58:40

Request a Transfer In token

Get Status