Init Transaction

POST

/transfer/v1/init

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

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/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": "string",
        "key1": "string",
        "key2": "string"
    },
    "fullResponse": "v2",
    "webhooks": {
        "events": [
            "approvedTransaction"
        ],
        "headers": [
            {
                "label": "string",
                "value": "string"
            }
        ],
        "urls": [
            "string"
        ]
    }
}'

Response Example

201 - Example 1

{
    "redirectUrl": "string",
    "bankId": "string",
    "bankName": "string",
    "bank": "string",
    "ticketNumber": "string",
    "transactionReference": "string",
    "details": {
        "status": "string",
        "amount": {
            "currency": "string",
            "iva": 0,
            "subtotalIva": 0,
            "subtotalIva0": 0
        },
        "created": 0,
        "description": "string",
        "documentNumber": "string",
        "documentType": "RUT",
        "email": "string",
        "merchantId": "string",
        "merchantName": "string"
    }
}

Modified at 2026-04-16 16:52:46

Get Bank List

Request a Transfer In token