Pago de servicios · México
Paga impuestos federales en México por referencia, con una sola API.
BillPay paga referencias gubernamentales a través de la API de payouts que ya usas. Disponible hoy en México, en MXN, para el pago de impuestos federales al SAT.
- México · MXN
- Impuestos federales del SAT
- Doble firma opcional
México · MXN- México, en pesos mexicanos
- MXN
- Impuestos federales, billType 0098
- SAT
- Paso de aprobación antes de enviar un pago
- Opcional
- En cada cambio de estado
- Webhook
Por qué BillPay
Pagos de impuestos dentro de tu producto
Tus clientes no deberían salir de tu plataforma para pagarle al SAT. BillPay convierte una referencia de impuestos en un payout más.
Una sola integración
BillPay es un método de payout (tipo BillPay, código 0119). Si ya envías payouts, tienes casi toda la integración hecha.
Pago por referencia
Envía el tipo de pago, la referencia y el monto. Localpayment paga la referencia en nombre de tu cliente.
Aprobaciones opcionales
Agrega requireAuth para que un segundo usuario autorizado apruebe antes de que se pague nada.
Estados claros
Siete estados documentados, de PENDING a COMPLETED, FAILED, EXPIRED o REVERSED.
Se paga desde una cuenta dedicada
Los pagos se debitan de una cuenta de Localpayment fondeada para pagos de impuestos y servicios.
Conciliado con todo lo demás
Los pagos aparecen en los mismos reportes, actividad y webhooks que el resto de tus operaciones.
Cómo funciona
De la referencia al pago, en cuatro pasos
- 01
Envía la referencia
Llama a POST /api/payout/ con el tipo BillPay (código 0119), billType 0098, la billReference del SAT y el monto.
- 02
Validación
Localpayment revisa la solicitud y la acepta con tu externalId. El monto es el que declara tu integración.
- 03
Aprobación (opcional)
Con requireAuth, un segundo usuario aprueba en el Business Portal o por API antes de enviar el pago.
- 04
Pagado + webhook
La referencia se paga y un webhook firmado informa COMPLETED, listo para conciliar con el resto de tus payouts.
Estados
Cada estado de la transacción, claramente definido
Cada pago informa uno de siete estados, por webhook y a través de la API de estado de transacciones.
Pendiente (PENDING)
- Qué significa
- Aceptado y a la espera de procesarse.
Pendiente de autorización (PENDING_AUTH)
- Qué significa
- A la espera de un segundo aprobador (requireAuth).
En proceso (IN_PROGRESS)
- Qué significa
- La referencia se está pagando.
Completado (COMPLETED)
- Qué significa
- La referencia fue pagada.
Fallido (FAILED)
- Qué significa
- No se pudo completar el pago; la respuesta indica el motivo.
Expirado (EXPIRED)
- Qué significa
- El pago superó el tiempo límite de procesamiento.
Revertido (REVERSED)
- Qué significa
- Un pago procesado fue revertido.
Tu integración declara el monto; Localpayment no lo valida contra la referencia. Descripciones resumidas. Consulta la guía de BillPay en la documentación para ver las definiciones exactas y los códigos de error.
Para quién es
Pensado para plataformas que atienden a empresas mexicanas
Integra el pago de impuestos federales donde tus clientes ya gestionan su dinero y elimina el paso en el que salen de tu producto para pagar.
- Software contable, de nómina y ERP: paga impuestos federales desde tu producto
- Fintechs y billeteras empresariales: permite pagarle al SAT desde el saldo
- Proveedores de servicios empresariales: automatiza el pago de impuestos de las empresas que gestionas
Resumen
USD
1.284.560,00
+4,2 %
BRL
3.420.118,40
+12,8 %
MXN
8.905.332,10
+6,1 %
- Pay-in · Pixorder_8F2K-1043+ R$ 1.250,00
- Payout · SPEIseller_0921− MX$ 18.400,00
- FX · BRL → USDfx_3b7q250.000,00 USD
- Pay-in · Bre-Border_9A1C-2210+ COP 890.000
Para desarrolladores
Un pago de impuestos es un payout con referencia
Usa el endpoint Create Payout con el método BillPay y los datos de pago del beneficiario. Autentícate con un token Bearer y recibe el resultado por webhook firmado.
- paymentMethod.type BillPay, código 0119
- beneficiary.billType 0098 (impuestos federales, SAT) y billReference
- requireAuth opcional para una segunda aprobación
# Solicitud ilustrativa — consulta docs.localpayment.com para el contrato exacto
curl -X POST https://api.stage.localpayment.com/api/payout/ \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"externalId": "9a7e5c3b-0000-4000-8000-000000000119",
"paymentMethod": { "type": "BillPay", "code": "0119", "flow": "DIRECT" },
"country": "MEX",
"currency": "MXN",
"amount": 12500.00,
"accountNumber": "<your-account-number>",
"requireAuth": true,
"beneficiary": { "billType": "0098", "billReference": "0426ABCD12345678901X" },
"sender": { "type": "COMPANY", "name": "Nortia Commerce S.A. de C.V." },
"merchant": { "type": "COMPANY", "name": "<your-company-name>" }
}'Casos de uso
Quién paga impuestos a través de la API
Fintechs y billeteras
Permite que tus usuarios empresa paguen referencias del SAT desde el saldo de su billetera.
Fintechs y billeteras —SaaS
Plataformas contables y ERP que declaran y pagan impuestos por sus clientes.
SaaS —Plataformas de pago
Suma pagos de impuestos a los servicios de pago que ya ofreces en México.
Plataformas de pago —B2B y alto valor
Paga obligaciones fiscales grandes con aprobación de doble firma.
B2B y alto valor —
Preguntas frecuentes
¿En qué países está disponible BillPay?
BillPay está disponible en México, en MXN. Si necesitas pagos de servicios o impuestos en otro mercado, conversa con nuestro equipo sobre tu caso de uso.
¿Qué pagos puedo hacer?
Hoy el catálogo de billType cubre impuestos federales pagados al SAT (billType 0098).
¿Qué datos necesito enviar?
El tipo de pago, la referencia y el monto, junto con los campos estándar de un payout, como tu externalId y tu número de cuenta.
¿Es una integración aparte?
No. BillPay es un método de pago de la API de payouts, así que usa la misma autenticación, estados, webhooks y reportes que tus otros payouts.
¿Puedo agregar un paso de aprobación?
Sí. Envía el pago con requireAuth y quedará en PENDING_AUTH hasta que un segundo usuario autorizado lo apruebe.
¿Cómo sé que el pago se realizó?
Recibes un webhook firmado cuando cambia el estado y puedes consultar la API de estado de transacciones en cualquier momento con tu externalId.
¿En qué moneda se pagan los impuestos?
En pesos mexicanos (MXN), debitados de una cuenta de Localpayment en México fondeada para pagos de impuestos y servicios. Fondéala con cobros locales o un Wire In y usa FX para convertir desde una moneda fuerte cuando haga falta.
¿Hay límites de monto?
El mínimo es MXN 0,01 y no hay monto máximo. El monto que envías debe coincidir con el de la referencia.
También en la misma API
Payouts
Pagos a cuentas bancarias por rieles locales en 14 países y a billeteras en 9.
Payouts —Business Portal
Revisa, aprueba y sigue cada pago en un solo lugar.
Business Portal —Conciliación y reportes
Reportes, APIs y webhooks para equipos de finanzas.
Conciliación y reportes —Cobertura
Presencia licenciada, registrada o supervisada en 18 países y rieles locales en 14, país por país.
Cobertura —Directorio de métodos de pago
Cada método documentado, con códigos, límites y velocidad por país.
Directorio de métodos de pago —Guía rápida para desarrolladores
Obtén un token, envía tu primera solicitud y recibe un webhook en Stage.
Guía rápida para desarrolladores —
Automatiza el pago de impuestos en México
Suma BillPay a tu integración de payouts y permite que tus clientes le paguen al SAT sin salir de tu producto.