Init Transaction

POST

/transfer/v1/init

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

Request

Header Params

Body Params application/json

Examples

Responses

🟢201

application/json

Bodyapplication/json

🟠400

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api-uat.kushkipagos.com/transfer/v1/init' \
--header 'Private-Merchant-Id;' \
--header 'Content-Type: application/json' \
--data '{
    "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": {
            "headers": [
                {
                    "label": "json",
                    "value": "12"
                }
            ]
        },
        "urls": [
            "string"
        ]
    }
}'

Response Example

201 - Ecuador with fullResponse v2

{
    "redirectUrl": "https://api-uat.kushkipagos.com/transfer/v1/agent?token=f4a51394506448b496d54d55c0ea22ec&mid=20000000101848293000",
    "transactionReference": "3a4c3f75-258e-4738-94b8-54461364b167",
    "details": {
        "status": "initializedTransaction",
        "amount": {
            "currency": "USD",
            "iva": 0,
            "subtotalIva": 0,
            "subtotalIva0": 50
        },
        "created": 1671728463198,
        "description": "Description of the payment.",
        "documentNumber": "1716458334",
        "documentType": "RUC",
        "email": "user@example.com",
        "merchantId": "20000000101848293000",
        "merchantName": "Mi Comercio Ecuador"
    }
}

Modified at 2026-07-23 16:01:52

Request a Transfer In token

Get Status