1. Payin
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
        POST
    • Payout
      • Notificaciones
      • Create payout
    • Débito automático
      • Affiliation
      • Charge
  1. Payin

Create payin

POST
/{{api_version}}/payin/{{merchant_id}}
Descripción
Este endpoint permite crear una transacción Payin (código/URL de pago) para que el deudor complete el pago de un servicio, crédito, cuota, etc.
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 payin_webhook del merchant ~500 ms después de crear el payin.
Prefijos reservados
order_id empieza porEstado enviado en el webhook
DEMO_AUTHORIZEDAUTHORIZED
DEMO_REJECTEDREJECTED
DEMO_EXPIREDEXPIRED
El sufijo es libre: DEMO_AUTHORIZED_001, DEMO_REJECTED_test, etc.
Comportamiento
La respuesta del create es idéntica a la de un payin normal (status: "PENDING", url: "https://demo.kambia.app").
El webhook que recibe el merchant tiene el mismo formato y firma (x-kambia-signature) que una notificación real.
Si el merchant no tiene payin_webhook configurado, la notificación se descarta.

Solicitud

Parámetros del Body application/json

Ejemplos

Respuestas

🟢201Created
application/json
Bodyapplication/json

Respuesta Ejemplo de Respuesta
{
    "status_code": 201,
    "message": "Payin created successfully",
    "payin": {
        "id": "MONTRX2167133326031877710",
        "order_id": "ORDER_123",
        "amount": "250.00",
        "currency": "PEN",
        "method": "bank_transfer",
        "status": "PENDING",
        "url": "https://cert.direct.monnet.io/voucher/12/11223361?verification=27d3ff58ddfd7b0ad2dafe9745cd3fede03f507240c77868d98e666cc1278c2cd90a9883107f875e115c9c6c3fda4c1328bdb008eb8f577e124d89dd7dc3e815"
    }
}
Modificado en 2026-08-26 01:13:20
Anterior
Notificaciones
Siguiente
Notificaciones
Built with