Saltar al contenido principal
Desembolso de pagos obligatorios de impuestos, facturas y servicios en México. Esta descripción general abarca el alcance, el flujo de pagos y los estados de las transacciones. Los pagos de impuestos, facturas y servicios son un método de payout de Localpayment (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 billType validado para los tipos de impuestos o servicios que planeas pagar (consulta Catálogo de tipos de factura más abajo).

Flujo de pagos

  1. Tú envías una solicitud a POST /api/payout/ con paymentMethod.type establecido en BillPay, incluyendo billType y billReference en el objeto beneficiary.
  2. Localpayment valida los campos requeridos y el catálogo de billType.
  3. Si requireAuth es true, la transacción permanece en PendingAuth hasta que tú llames al endpoint de autorización.
  4. Localpayment gestiona el pago con la autoridad tributaria o la entidad emisora ​​de la factura.
  5. 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 campo billType identifica el impuesto o servicio que se está pagando. El catálogo disponible para México es el siguiente:
El catálogo de billType crece a medida que se añaden nuevos tipos de impuestos y servicios. Confirma el catálogo actual con tu gestor de cuenta de Localpayment antes de implementar un nuevo tipo.

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.
Última modificación el 10 de noviembre de 2026