Init Transaction

POST

/payouts/transfer/v1/init

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

`webhooks` field is an array

Send webhook configurations as an array. Example:

{
  "token": "{{token}}",
  "amount": { "subtotalIva": 0, "subtotalIva0": 1000, "iva": 0 },
  "webhooks": [
    {
      "events": ["approvedTransaction", "declinedTransaction"],
      "headers": [{ "label": "json", "value": "12" }],
      "urls": ["https://your-endpoint.com/webhook"]
    }
  ]
}

WARNING

Got a suggestion on this documentation? Contact Us.

Request

Header Params

Body Params application/json

Examples

Responses

🟢201

application/json

Body

🟠400

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api-uat.kushkipagos.com/payouts/transfer/v1/init' \
--header 'Private-Merchant-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "token": "string",
    "amount": {
        "subtotalIva": 0,
        "subtotalIva0": 0,
        "iva": 0,
        "extraTaxes": {
            "iac": 0,
            "tasaAeroportuaria": 0,
            "agenciaDeViaje": 0
        }
    },
    "metadata": {
        "key0": "value0",
        "key1": "value1",
        "key2": "value2"
    },
    "webhooks": [
        {
            "events": [
                "approvedTransaction"
            ],
            "headers": {
                "headers": [
                    {
                        "label": "json",
                        "value": "12"
                    }
                ]
            },
            "urls": [
                "string"
            ]
        }
    ],
    "fullResponse": "v2"
}'

Response Example

201 - Example 1

{
    "details": {
        "amount": {
            "subtotalIva": 0,
            "iva": 0,
            "subtotalIva0": 0,
            "extraTaxes": {
                "tasaAeroportuaria": 0,
                "agenciaDeViajes": 0,
                "iac": 0
            },
            "currency": "string"
        },
        "bankId": "string",
        "created": 0,
        "documentNumber": "string",
        "documentType": "string",
        "maskedAccountNumber": "string",
        "merchantId": "string",
        "merchantName": "string",
        "status": "string",
        "transactionId": "string",
        "transactionType": "string",
        "keyResolution": {
            "keyValue": "string",
            "ownerName": "string"
        }
    },
    "status": "INITIALIZED",
    "ticketNumber": "string",
    "transactionReference": "string"
}

Modified at 2026-04-15 21:33:35

Request a Transfer Out token

Get Status

Init Transaction

webhooks field is an array#

Request

Responses

`webhooks` field is an array