Iniciar transacción

https://api-uat.kushkipagos.com

POST

/payouts/transfer/v1/init

Inicia la transacción con un token de Transfer Out entregado por Kushki que representa el pago del cliente.

El campo `webhooks` es un array

Envía las configuraciones de webhook como un array. Ejemplo:

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

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 '/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,
            "propina": 0,
            "tip": 0,
            "stateTax": 0,
            "municipalTax": 0,
            "reducedStateTax": 0
        }
    },
    "metadata": {
        "reference": "ORD-20240317-001",
        "customer_email": "user@example.com",
        "device": "SUNMI-P3"
    },
    "webhooks": [
        {
            "events": [
                "approvedTransaction"
            ],
            "headers": [
                {
                    "label": "string",
                    "value": "string"
                }
            ],
            "urls": [
                "string"
            ]
        }
    ],
    "fullResponse": "v2"
}'

Response Example

201 - short response

{
    "status": "INITIALIZED",
    "ticketNumber": "1574298975417951",
    "transactionReference": "aef8884f-cd4d-4b9b-9efa-ad582629e4f2"
}

Modified at 2026-09-11 15:10:17

Solicitar un token de Transfer Out

Consultar estado

Iniciar transacción

El campo webhooks es un array#

Request

Responses

El campo `webhooks` es un array