Payouts · México
Pago de impuestos y servicios en México, desde la plataforma que ya usas.
Paga impuestos federales desde la misma plataforma que ya usas, con la referencia de pago correspondiente, y sigue el estado de cada pago con notificaciones por webhook.
- México · MXN
- Impuestos federales
- Notificaciones por webhook
México · MXN- 09:41:02.11409:41:02PayIn100 INPROGRESS20084 ms
- 09:41:05.90209:41:05PayIn200 COMPLETED20091 ms
- 09:42:18.33009:42:18PayOut100 INPROGRESS20077 ms
- 09:42:40.01809:42:40PayOut200 COMPLETED20088 ms
- 09:43:00.55109:43:00VirtualAccount200 COMPLETED20080 ms
POST https://example-merchant.com/webhooks/localpayment
x-Signature: HMAC-SHA256 3f9a1c0e…b47e2b
{ "transactionType": "PayIn", "transactionFlow": "DIRECT",
"data": { "externalId": "order_8F2K-1043",
"status": { "code": "200", "description": "COMPLETED" } } }Beneficios clave
Simplifica tus operaciones de pago de impuestos en México
El pago de impuestos y servicios es un método de payout: en lugar de enviar fondos a una cuenta bancaria, pagas una referencia gubernamental o de servicios en nombre del beneficiario.
Paga impuestos federales desde la misma plataforma
Un pago de impuestos es un payout más (BillPay, código 0119) en la API de Localpayment que ya usas.
Paga con la referencia de pago
Envía el tipo de impuesto y la referencia de pago correspondiente; en México, la referencia de pago del SAT.
Disponible en México (MEX / MXN)
Para clientes que operan en México, con pagos en pesos mexicanos.
Sigue el estado por webhook
Tu backend recibe el estado final de cada pago mediante notificaciones por webhook.
Cómo funciona
De la referencia de pago al pago completado
- 01
Envía el pago
Llama a POST /api/payout/ con paymentMethod.type BillPay, y billType y billReference en el objeto beneficiary.
- 02
Validación
Localpayment valida los campos obligatorios y el catálogo de billType.
- 03
Aprobación (opcional)
Con requireAuth en true, el pago queda en PENDING_AUTH hasta que llames al endpoint de autorización.
- 04
Pago
Localpayment procesa el pago con la autoridad fiscal o el emisor.
- 05
Webhook
Localpayment actualiza el estado de la transacción y te lo notifica por webhook.
Estados de la transacción
Cada estado del pago, claramente definido
PENDING
- Tipo
- Intermedio
- Descripción
- La transacción se recibió y se está procesando.
PENDING_AUTH
- Tipo
- Intermedio
- Descripción
- requireAuth era true: espera a que llames al endpoint de autorización.
IN_PROGRESS
- Tipo
- Intermedio
- Descripción
- El emisor está procesando la transacción.
COMPLETED
- Tipo
- Final
- Descripción
- El pago se procesó correctamente.
FAILED
- Tipo
- Final
- Descripción
- El pago fue rechazado; el arreglo errors de la respuesta indica el motivo.
EXPIRED
- Tipo
- Final
- Descripción
- La transacción superó el tiempo límite de procesamiento.
REVERSED
- Tipo
- Final
- Descripción
- El pago fue revertido.
Localpayment no valida que el monto declarado coincida con el monto codificado en la referencia: tu integración declara el monto correcto.
Para desarrolladores
Un pago de impuestos es un payout con una referencia
Usa el endpoint Create a Payout con paymentMethod.type BillPay. En lugar de una cuenta bancaria, el objeto beneficiary lleva el tipo de impuesto y la referencia oficial.
- paymentMethod.type BillPay, código 0119, flujo DIRECT
- beneficiary.billType 0098: impuestos federales
- beneficiary.billReference: la referencia de pago del SAT de 20 caracteres
# Solicitud de ejemplo en Stage — consulta docs.localpayment.com para el contrato completo
curl --request POST \
--url https://api.stage.localpayment.com/api/payout/ \
--header 'Authorization: Bearer <your_access_token>' \
--header 'Content-Type: application/json' \
--data '{
"externalId": "550e8400-e29b-41d4-a716-446655440000",
"country": "MEX",
"currency": "MXN",
"amount": 100.00,
"accountNumber": "<your_account_number>",
"paymentMethod": { "type": "BillPay", "code": "0119", "flow": "DIRECT" },
"beneficiary": { "billType": "0098", "billReference": "20260713000000000001" },
"sender": { "type": "INDIVIDUAL", "name": "Jane", "lastName": "Doe" },
"merchant": { "type": "COMPANY", "name": "Merchant Name" }
}'Preguntas frecuentes
¿Dónde está disponible?
En México (MEX), en pesos mexicanos (MXN). Funciona como un payout: Localpayment envía los fondos a una referencia gubernamental o de servicios en nombre del beneficiario.
¿Qué impuestos puedo pagar hoy?
El catálogo de billType para México cubre impuestos federales (billType 0098). El catálogo crece a medida que se suman nuevos tipos de impuestos y servicios; confírmalo con tu ejecutivo de cuenta antes de salir a producción con un tipo nuevo.
¿Qué necesito para empezar?
Credenciales de la API, una cuenta dedicada fondeada para pagos de impuestos y servicios, el billType que vas a pagar y la referencia de pago (en México, la del SAT) que te da el contribuyente o el emisor.
¿Cómo sigo cada pago?
Localpayment notifica el estado final a tu endpoint por webhook, con el externalId, el billType y la billReference. Si una entrega falla, se reintenta hasta 3 veces con backoff exponencial, y siempre puedes consultar la transacción por la API.
¿Localpayment verifica el monto?
No. Tu integración declara el monto codificado en la referencia y verifica que la referencia no se haya pagado antes, ya que una referencia pagada no se puede reutilizar. Las referencias del SAT vencidas se rechazan una vez validadas contra el SAT.
También en la misma API
Payouts
Pagos a cuentas bancarias por rieles locales en 14 países y a billeteras en 9.
Payouts —Conciliación y reportes
Reportes, APIs y webhooks para equipos de finanzas.
Conciliación y reportes —Pagos en México
Métodos, rieles y licencias en México.
Pagos en México —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 —
Simplifica tus operaciones de pago de impuestos en México
Paga impuestos federales desde la misma plataforma que ya usas y sigue cada pago con notificaciones por webhook.