1. Payout
API Kambia
  • Introducción
    • API Kambia
    • Credenciales
    • Autenticación
    • Verificación
      POST
  • Servicios
    • Catálogo de códigos
    • Contrato digital
      • Notificaciones
      • Plantilla digital
      • Create signature
    • Payin
      • Notificaciones
      • Create payin
    • Payout
      • Notificaciones
      • Create payout
        POST
    • Débito automático
      • Affiliation
      • Charge
  1. Payout

Create payout

POST
/{{api_version}}/payout/{{merchant_id}}
Descripción
Crea una solicitud de transferencia bancaria
Autenticación
Revisa la sección aquí
Modo demo (notificaciones automáticas)
Para facilitar las pruebas de integración del webhook, la API detecta automáticamente ciertos prefijos en el order_id y envía la notificación correspondiente al payout_webhook del merchant ~500 ms después de crear el payout.
Prefijos reservados
order_id empieza porEstado enviado en el webhook
DEMO_SUCCESSSUCCESS
DEMO_REJECTEDREJECTED
El sufijo es libre: DEMO_SUCCESS_001, DEMO_REJECTED_test, etc.
Comportamiento
La respuesta del create es idéntica a la de un payout normal (status: "PENDING").
El webhook tiene el mismo formato y firma (x-kambia-signature) que una notificación real.
En SUCCESS demo se incluye receipt_url: "https://demo.kambia.app" (enlace de prueba).

Solicitud

Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢201Created
application/json
Bodyapplication/json

🟠400Missing field
🟠400Invalid field
🟠400Invalid bank details
Respuesta Ejemplo de Respuesta
201 - Created
{
    "status_code": 201,
    "message": "Payout created successfully",
    "payout": {
        "id": "645",
        "country": "PER",
        "amount": 25000,
        "currency": "PEN",
        "order_id": "CU_1767031321",
        "status": "CREATED",
        "created_at": "2026-01-19T21:31:16.475102"
    }
}
Modificado en 2026-08-26 01:13:20
Anterior
Notificaciones
Siguiente
Affiliation
Built with