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,
            "propina": 0,
            "tip": 0,
            "stateTax": 0,
            "municipalTax": 0,
            "reducedStateTax": 0
        }
    },
    "metadata": {
        "key0": "string",
        "key1": "string",
        "key2": "string"
    },
    "fullResponse": "v2",
    "expirationDate": "2019-08-24T14:15:22.123Z",
    "webhooks": {
        "webhooks": [
            {
                "events": [
                    "approvedTransaction",
                    "declinedTransaction"
                ],
                "headers": [
                    {
                        "label": "json",
                        "value": "12"
                    }
                ],
                "urls": [
                    "https://eof2hhkrta4ooo1.m.pipedream.net"
                ]
            }
        ]
    }
}'

Response Example

201 - Peru with fullResponse v2

{
    "redirectUrl": "https://api-uat.kushkipagos.com/transfer/v1/agent?token=aaea380f07a944f3981d47998bdd8d80&mid=20000000108850614000",
    "transactionReference": "28e6ac31-0af1-479a-9a6f-1a596bba6aea",
    "details": {
        "status": "initializedTransaction",
        "amount": {
            "currency": "PEN",
            "iva": 0,
            "subtotalIva": 0,
            "subtotalIva0": 90
        },
        "created": 1658349538144,
        "description": "Description of the payment.",
        "documentNumber": "123456789",
        "documentType": "RUC",
        "email": "user@example.com",
        "merchantId": "20000000108850614000",
        "merchantName": "Tu comercio"
    }
}

Modified at 2026-07-28 15:11:33

Request a Transfer In token

Get Status