> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localpayment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Resumen de pagos de impuestos, facturas y servicios

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»](https://docs.localpayment.com/es/docs/send-a-bill-payment.md) .

## Alcance

| Campo | Valor |
| - | - |
| **País** | México (MEX) |
| **Divisa** | MXN |
| **Tipo de operación** | Payout |
| **Método de pago** | Pagos de impuestos, facturas y servicios (BillPay, código 0119) |
| **Flujo** | DIRECT |

> [!NOTE]
>
> 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](https://docs.localpayment.com/es/docs/api-keys-and-environments.md) 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](#billtype-catalog) más abajo).

***

## Flujo de pagos

```mermaid theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#31467c', 'primaryTextColor': '#ffffff', 'primaryBorderColor': '#0c1a29', 'actorBkg': '#31467c', 'actorBorder': '#0c1a29', 'actorTextColor': '#ffffff', 'actorLineColor': '#0c1a29', 'signalColor': '#0c1a29', 'signalTextColor': '#0c1a29', 'labelBoxBkgColor': '#31467c', 'labelBoxBorderColor': '#0c1a29', 'labelTextColor': '#ffffff', 'loopTextColor': '#0c1a29', 'noteBkgColor': '#ffffff', 'noteBorderColor': '#31467c', 'noteTextColor': '#0c1a29'}}}%%
sequenceDiagram
  autonumber
  participant Dev as Su backend
  participant LP as Localpayment
  participant Fisco as Autoridad fiscal / Facturador

  Dev->>LP: Enviar el pago de la cuenta (tipo de impuesto y referencia de la cuenta)
  LP->>LP: Verificar los datos del pago
  alt Se requiere aprobación
    LP-->>Dev: El pago está esperando su aprobación
    Dev->>LP: Aprobar el pago
  end
  LP->>Fisco: Enviar el pago
  Fisco-->>LP: Confirmar que el pago fue recibido
  LP-->>Dev: Notificarle que el pago está completo
```

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](https://docs.localpayment.com/es/docs/approvals-and-double-signature.md).
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](https://docs.localpayment.com/es/docs/send-a-bill-payment.md#testing-in-stage) .

![Localpayment](https://docs.localpayment.com/images/brand/logo-localpayment.png)

Experiencia de pago del usuario final

Restablecer

![](https://docs.localpayment.com/images/flags/mexico.png)
México

Su app: interfaz del usuario final

your-app.example.com/payments/taxes

Localpayment: traza de la transacción

***

## Estados de transacción

| Estado | Tipo | Descripción |
| - | - | - |
| `PENDING` | Intermedio | La transacción se recibió y se está procesando. |
| PENDING\_AUTH | Intermedio | requireAuth era verdadero. Esperando a que llames al endpoint de autorización. |
| IN\_PROGRESS | Intermedio | La transacción está siendo procesada por el emisor de la factura. |
| `COMPLETED` | Final | El pago se procesó correctamente. |
| `FAILED` | Final | El pago fue rechazado. Revisa la lista de errores en la respuesta. |
| `EXPIRED` | Final | La transacción superó el límite de tiempo de procesamiento. |
| `REVERSED` | Final | El pago fue anulado. |

***

## 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:

| Código | Descripción |
| - | - |
| 0098 | Impuestos federales |

> [!WARNING]
>
> 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

> [card] [Enviar un pago de impuestos, facturas o servicios](https://docs.localpayment.com/es/docs/send-a-bill-payment.md)
>
> Referencia de la API, ejemplos de solicitudes y respuestas, y notificaciones de webhook.

> [card] [Aprobaciones y doble firma](https://docs.localpayment.com/es/docs/approvals-and-double-signature.md)
>
> Aprende cómo autorizar un pago creado con requireAuth.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.