Saltar al contenido principal
Boletos y pago de facturas cubre el riel de boleto de Brasil: la emisión de boletos bancários y el pago de facturas como documentos de impuesto DARF y facturas de servicios públicos y de concesionarias. En la plataforma Lerian, operas esta capacidad desde el módulo Payments en Lerian Console, un plugin gestionado para Midaz aprovisionado para tu organización.

Qué puedes hacer


  • Emite boletos con fechas de vencimiento, registrados en tu ledger de Midaz. A través de la API, un boleto también puede llevar multas, intereses y descuentos, y puedes elegir su nosso número.
  • Paga facturas (pagos de impuesto DARF y facturas de servicios públicos y de concesionarias) directamente desde la Console.
  • Consulta una factura por su línea digitable a través de la API antes de pagarla. La respuesta muestra el monto, las fechas y quién recibe el dinero.
  • Haz seguimiento de las operaciones desde un dashboard con tarjetas KPI, actividad reciente y acciones rápidas.

Cómo un pago de factura mueve el dinero


  1. El ledger reserva el monto en la cuenta de fondeo. Si el saldo o el límite de sobregiro no lo permiten, el pago falla aquí, y BTG no lo recibe.
  2. Payments envía el pago a BTG.
  3. Cuando BTG acepta el pago, la API responde 201 y el pago queda CREATED. Cuando el resultado en BTG es desconocido, la API responde 202 y el pago queda UNCONFIRMED.
  4. Para un pago de boleto bancario o de servicio público, la conciliación lee el pago en BTG. Si BTG no tiene registro de él durante toda la ventana que define el despliegue, el pago falla con PBP-0211, y Payments libera los fondos.
  5. Para un pago de DARF, los fondos siguen reservados hasta que llega el resultado de BTG.
No envíes de nuevo un pago UNCONFIRMED con un nuevo Idempotency-Key. BTG puede tenerlo ya, y una segunda solicitud puede pagar la factura dos veces. Reenviar con la misma clave es seguro.

Encuentra un pago después de un error


Una solicitud que crea un pago puede terminar sin el id del pago, por ejemplo después de un timeout o de una respuesta con estado 5xx. Primero, envía la solicitud de nuevo con el mismo Idempotency-Key. Después de un 409 con PBP-0007 o de un 503 con PBP-0008, espera y envíala de nuevo con la misma clave. Después de que la misma clave devuelva otra respuesta, llama a GET /v1/payments con idempotencyKey igual a esa clave para encontrar lo que la solicitud creó. Envía el mismo X-Organization-Id de esa solicitud. Después de enviar una solicitud de nuevo con un nuevo Idempotency-Key, no la envíes de nuevo con la clave anterior. La clave anterior puede ejecutar la solicitud otra vez, y las dos solicitudes pueden pagar.

Por dónde empezar


Payments en Lerian Console

Activa el plugin Payments y haz un primer recorrido por el módulo.

Resumen de Payments

El dashboard: tarjetas KPI, operaciones recientes y atajos.

Boletos

Emite, consulta y gestiona boletos.

Pago de facturas

Paga DARF y facturas de servicios públicos desde la Console.