paymentMethod.type: BillPay) para pagos obligatorios de impuestos, facturas y servicios. En lugar de enviar fondos a la cuenta bancaria del beneficiario, tú envías fondos a una referencia de facturación gubernamental o de servicios en nombre del beneficiario.
Este artículo está dirigido a integradores que necesitan desembolsar estos pagos mediante programación. Cubre el alcance, el flujo de pago de principio a fin y los estados de la transacción. Para consultar la referencia de la API y ejemplos de código, ve «Enviar un pago de impuestos, facturas o servicios» .
Alcance
Localpayment no valida que el
amount declarado coincida con el importe codificado en la referencia de la factura. Tu integración es responsable de declarar el importe correcto antes de enviar la solicitud.Antes de comenzar
- Credenciales API válidas (token de acceso).
- Una cuenta específica financiada para el pago de impuestos y facturas.
- El catálogo de
billTypevalidado para los tipos de impuestos o servicios que planeas pagar (consulta Catálogo de tipos de factura más abajo).
Flujo de pagos
- Tú envías una solicitud a
POST /api/payout/conpaymentMethod.typeestablecido enBillPay, incluyendobillTypeybillReferenceen el objetobeneficiary. - Localpayment valida los campos requeridos y el catálogo de
billType. - Si
requireAuthestrue, la transacción permanece enPendingAuthhasta que tú llames al endpoint de autorización. - Localpayment gestiona el pago con la autoridad tributaria o la entidad emisora de la factura.
- Localpayment actualiza el estado de la transacción y te notifica mediante un webhook.
Véalo en acción
La demostración interactiva a continuación muestra el flujo desde ambos lados: lo que el usuario final ve en tu aplicación y lo que sucede dentro de Localpayment hasta que tu backend recibe el webhook. Selecciona una línea de captura para simular un pago completado o rechazado. Los valores coinciden con el catálogo de pruebas de Stage .Estados de transacción
Catálogo de tipos de factura
El campobillType identifica el impuesto o servicio que se está pagando. El catálogo disponible para México es el siguiente:
Próximos pasos
Enviar un pago de impuestos, facturas o servicios
Referencia de la API, ejemplos de solicitudes y respuestas, y notificaciones de webhook.
Aprobaciones y doble firma
Aprende cómo autorizar un pago creado con requireAuth.

