Casos de uso

Bre-B Participant te da un conjunto pequeño de campos que, combinados, cubren la mayoría de formas en que un negocio recibe o envía dinero. Un caso de uso es una combinación recomendada de esos campos para un escenario concreto — una compra única, una suscripción, una donación, un pago a proveedores. Esta sección convierte "¿qué configuro para X?" en una receta que puedes copiar.

No existe un endpoint especial de "suscripción" o "donación". Siempre creas un recaudo (para recibir) o una transferencia saliente (para enviar); la configuración que eliges es lo que hace que se comporte como una suscripción o una donación.

Las decisiones que definen un recaudo

Cuando recibes dinero (Recaudo), cuatro decisiones moldean el comportamiento:

• ¿Cuántas veces se puede pagar? usage_mode es single_use (acepta un solo pago exitoso y se cierra) o multiple_use (sigue aceptando pagos hasta alcanzar un tope, o indefinidamente).
• ¿Cuánto, en total? total_maximum_amount y total_minimum_amount acotan la vida del recaudo. Ponlos iguales para un precio fijo; omite ambos para dejarlo abierto indefinidamente.
• ¿Cuánto por pago? minimum_attempt_amount y maximum_attempt_amount acotan cada pago individual — útil para cuotas y recargas.
• ¿Cómo se comparte? Un QR dinámico lleva un monto fijo y una expiración corta (un checkout). Un QR estático no lleva monto y se puede imprimir o publicar para muchos pagadores.

Dos campos opcionales marcan el pago: custom_key_value (un sufijo legible en la llave de pago, p. ej. @MN{random}REFOREST) y custom_merchant_name (el nombre que ve el pagador).

Las decisiones que definen una transferencia saliente

Cuando envías dinero (Dispersiones), las decisiones son sobre el destinatario y la confianza:

• ¿Quién la recibe? Provee un query.value (una llave de pago que Mono resuelve por ti) o un target_id ya resuelto.
• ¿Necesitas confirmar la identidad primero? expected_creditor hace que Mono rechace la transferencia si el destinatario resuelto no coincide con quien esperabas — esencial para reembolsos.
• ¿Una o muchas? Un solo request puede llevar una transferencia o un lote de muchas, cada una con seguimiento independiente.

Elige tu rail

Próximos pasos

• Concepto de recaudos — la entidad que estas recetas configuran.
• Estados del recaudo — cómo funciona ready → minimum_paid → paid.
• Sandbox: recaudos — prueba una receta de punta a punta sin un banco real.