Recaudo por QR
Recibe un pago Bre-B de un pagador que escanea tu código QR.
Bre-B es el esquema interbancario de pagos instantáneos de Colombia — un rail en tiempo real similar a Pix de Brasil o UPI de India que permite a cualquier banco participante o entidad licenciada enviar y recibir fondos 24/7 en segundos. Un recaudo por QR es el flujo que tu negocio corre cuando quiere que un cliente te pague por Bre-B: generas un código QR que codifica una instrucción de pago, el cliente lo escanea desde su app bancaria, su banco envía la transferencia y Mono te notifica cuando llegan los fondos.
Este flujo es la mitad de payin de Bre-B Participant. Úsalo para checkout presencial, recargas en kiosco, páginas de donación o cualquier momento en que el pagador inicia un pago banco a banco usando su teléfono.
Esta página es un esqueleto de flujo y se expandirá con el request de generación de QR, el formato del payload EMVCo, el webhook de confirmación, errores comunes y un recorrido de sandbox.
Antes de empezar
Vas a necesitar:
- Una cuenta de Bre-B participant con Mono y credenciales OAuth de cliente. Ver Autenticación.
- Una cuenta tenant registrada que recibirá los fondos.
- Un endpoint de webhook que pueda recibir eventos de recaudo y verificar su firma — ver Firmas de webhook.
- Una clave de idempotencia por request de generación de QR.
Visión general de la secuencia
- Genera un recaudo — tu backend le pide a Mono un QR que codifique el monto, la moneda y una referencia que tú controlas.
- Muestra el QR — tu frontend o terminal renderiza el payload EMVCo como un código escaneable.
- El cliente paga — el pagador escanea el QR con su app bancaria y autoriza la transferencia.
- Recibe la confirmación — Mono dispara un webhook a tu endpoint con el resultado final, firmado con HMAC-SHA256.
- Concilia — tu sistema acredita la orden o libera la mercancía.
Pasos
El paso a paso completo (con ejemplos de curl, Node.js y Python para generación de QR, verificación y conciliación) está pendiente. Hasta que se publique, consulta:
- La referencia de API de Bre-B participant para los endpoints de recaudo.
- Firmas de webhook para verificar el evento de confirmación.
- Payloads de webhook para el envelope del evento y los schemas de payload.
Siguientes pasos
- Transferencia saliente — la contraparte de payout de este flujo.
- Sandbox: recaudos — simula un pago de cliente sin involucrar un banco real.
- Payloads de webhook — el evento que recibirás en un recaudo exitoso.