Antes de comenzar
- Credenciales API válidas (token de acceso).
- Una cuenta específica financiada para el pago de impuestos y facturas.
- El
billTypeque planeas pagar, validado con el catálogo de BillType. - La referencia de la factura (por ejemplo, una referencia de pago del SAT para México) obtenida del contribuyente o del emisor de la factura.
Endpoint
Para crear un payout de pago de impuestos, facturas o servicios, envía una solicitudPOST al endpoint Create a Payout con paymentMethod.type establecido en "BillPay".
Encabezados obligatorios
Solicitud
curl
Parámetros clave de la solicitud
La solicitud requiere varios objetos clave. Consulta la referencia Create a Payout para ver la lista completa de campos, incluidossender y merchant.
Gestión de la respuesta
Respuesta exitosa
Campos de respuesta clave
Respuesta de error
Consideraciones sobre la referencia de la factura
En México, elbillReference es la referencia de pago del SAT: una clave alfanumérica de 20 caracteres que identifica de forma única el concepto fiscal, el contribuyente y el periodo fiscal.
Pruebas en Stage
Para que puedas validar el flujo de extremo a extremo antes de salir a producción, Localpayment simula la respuesta del emisor de la factura en Stage siempre que elbeneficiary.billReference que tú envíes coincida con una de las líneas de captura fijas del catálogo siguiente.
Consulta Payout Status and Error Codes para ver la lista completa.
Webhooks
Localpayment te notifica el estado final de la transacción mediante webhook, con la misma estructura de payload que la respuesta anterior. La notificación incluye elstatus final, el externalId y el objeto beneficiary con billType y billReference. Consulta Webhooks para ver ejemplos de payload, validación de firma y configuración.
Reintentos
- Localpayment reintenta una entrega fallida del webhook hasta 3 veces con retroceso exponencial.
- Tu endpoint debe responder con HTTP 200 para confirmar la recepción. Cualquier otro código de estado cuenta como una entrega fallida.
- Si fallan los 3 reintentos, la transacción permanece en su estado final y tú puedes recuperarla manualmente a través de la API.
Próximos pasos
Resumen de pagos de impuestos, facturas y servicios
Alcance, flujo de pago y estados de la transacción.
Aprobaciones y doble firma
Aprende cómo autorizar un payout creado con requireAuth.

