Kamin en PSE
Acepta pagos PSE de redirección bancaria a través de Kamin Ledger. Escribes Intents firmados, escuchas Effects por webhook y rediriges al cliente a su banco — Kamin maneja el protocolo PSE internamente.
Cómo funciona el flujo de pago
Qué necesitas hacer
Obtener la lista de bancos
Llama al anchor del ledger para obtener la lista de bancos PSE activos y poblar el selector de bancos en tu formulario de pago. → Obtener Bancos Activos
Crear el Intent
Construye un intent PSE firmado con los datos personales del cliente, el código de banco y el monto, y envíalo a Kamin Ledger. El intent comienza en estado pending y Kamin lo registra con PSE automáticamente. → Cobrar un Pago — Crear el Intent
Escuchar la URL del banco
Registra un Effect que dispare con intent-proofs-added. Cuando llega el proof registered, extrae la pseUrl (la página de autorización del banco) y el trazabilityCode (CUS) de los datos del proof. → Manejar Webhooks — Effect 1
Redirigir al cliente
Envía al cliente a la pseUrl. Ellos autorizan el pago en el portal de su banco, y el banco los redirige de vuelta a la returnUrl que especificaste en el intent. → Cobrar un Pago — Redirección
Enviar la señal de confirmación
Cuando el cliente regresa a tu returnUrl, avisa a Kamin que el flujo bancario terminó para que cierre la transacción y transicione el intent a prepared. La señal es un proof confirmed agregado al intent. Si lo omites, Kamin cae de vuelta a consultar el estado final a PSE — el intent puede tardar hasta 21 minutos en cerrarse. → Cobrar un Pago — Enviar la señal de confirmación
Escuchar el estado final del Intent
Kamin escribe un proof prepared (éxito — lleva el número de recibo coreId) o mueve el intent a rejected (fallo — un proof failed lleva detail + reason). El rechazo puede ocurrir en la creación (antes de que se entregue pseUrl) o en el procesamiento de la transacción (tras el proof confirmed). Tu webhook recibe el resultado y actualiza la interfaz del cliente. Un proof prepared significa que PSE confirmó la transacción, pero los fondos aún no se han acreditado en tu wallet. → Manejar Webhooks — Manejar cada estado
Recibir la liquidación
Después del ciclo de liquidación de PSE, Kamin recibe los fondos, acredita el monto en tu wallet de cliente y mueve el intent a completed. Esto sucede automáticamente — no se requiere ninguna acción de tu parte. Recibes un webhook final cuando el intent alcanza el estado completed confirmando que el saldo está disponible.
Guías
- Conceptos Clave — Terminología PSE, estados del ciclo de vida del intent y modelos de comercio
- Obtener Bancos Activos — Obtención de lista de bancos y normalización de campos
- Manejar Webhooks — Contrato de webhook, formas de payload e idempotencia
- Cobrar un Pago — Implementación de extremo a extremo desde la creación del intent hasta el estado final del Intent
- Requisitos de Certificación — Las 7 pantallas requeridas por PSE y el texto exacto
Historial de cambios
- Agregado• Version inicial