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

# Visão geral de impostos, contas e pagamentos de serviços

Efetue pagamentos de impostos, contas e serviços obrigatórios no México. Esta visão geral abrange o escopo, o fluxo de pagamento e os estados da transação.

Pagamentos de impostos, contas e serviços é um método de payout da Localpayment (`paymentMethod.type: BillPay`) para pagamentos obrigatórios de impostos, contas e serviços. Em vez de enviar fundos para a conta bancária de um beneficiário, você envia fundos para uma referência de cobrança governamental ou de serviço em nome do beneficiário.

Este artigo destina-se a integradores que precisam efetuar esses pagamentos programaticamente. Ele aborda o escopo, o fluxo de pagamento de ponta a ponta e os estados da transação. Para obter a referência da API e exemplos de código, consulte [Enviar um pagamento de imposto, conta ou serviço](https://docs.localpayment.com/pt-br/docs/send-a-bill-payment.md).

## Escopo

| Campo | Valor |
| - | - |
| **País** | México (MEX) |
| **Moeda** | MXN |
| **Tipo de operação** | Payout |
| **Método de pagamento** | Pagamentos de impostos, contas e serviços (BillPay, código 0119) |
| **Fluxo** | DIRECT |

> [!NOTE]
>
> A Localpayment não valida se o `amount` declarado corresponde ao valor codificado na referência da conta. Sua integração é responsável por declarar o valor correto antes de enviar a requisição.

***

## Antes de começar

* [Credenciais de API](https://docs.localpayment.com/pt-br/docs/api-keys-and-environments.md) válidas (token de acesso).
* Uma conta dedicada, financiada para o pagamento de impostos e contas.
* O catálogo de `billType` validado para os tipos de imposto ou serviço que você pretende pagar (consulte o [Catálogo de Tipos de Fatura](#billtype-catalog) abaixo).

***

## Fluxo de pagamento

```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 Seu backend
  participant LP as Localpayment
  participant Fisco as Autoridade fiscal / Emissor da conta

  Dev->>LP: Envia o pagamento da conta (tipo de imposto e referência da conta)
  LP->>LP: Valida os dados do pagamento
  alt Aprovação necessária
    LP-->>Dev: Pagamento aguardando a sua aprovação
    Dev->>LP: Aprova o pagamento
  end
  LP->>Fisco: Envia o pagamento
  Fisco-->>LP: Confirma o recebimento do pagamento
  LP-->>Dev: Avisa que o pagamento foi concluído
```

1. Você envia uma requisição para `POST /api/payout/` com `paymentMethod.type` definido como `BillPay`, incluindo `billType` e `billReference` no objeto `beneficiary`.
2. A Localpayment valida os campos obrigatórios e o catálogo de `billType`.
3. Se `requireAuth` for `true`, a transação permanece em `PendingAuth` até que você chame o [endpoint de autorização](https://docs.localpayment.com/pt-br/docs/approvals-and-double-signature.md).
4. A Localpayment processa o pagamento junto à autoridade tributária ou ao emissor da fatura.
5. O Localpayment atualiza o status da transação e notifica você por meio de um webhook.

***

## Veja em ação

A demonstração interativa abaixo mostra o fluxo de ambos os lados: o que o usuário final vê no seu aplicativo e o que acontece dentro do Localpayment até que seu backend receba o webhook. Selecione uma linha de captura para simular um pagamento concluído ou rejeitado. Os valores correspondem ao [catálogo de testes do Stage](https://docs.localpayment.com/pt-br/docs/send-a-bill-payment.md#testing-in-stage).

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

Experiência de pagamento do usuário final

Redefinir

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

Seu app: interface do usuário final

your-app.example.com/payments/taxes

Localpayment: rastreamento da transação

***

## Estados de transação

| Status | Tipo | Descrição |
| - | - | - |
| `PENDING` | Intermediário | A transação foi recebida e está sendo processada. |
| PENDING\_AUTH | Intermediário | requireAuth era verdadeiro. Aguardando que você chame o endpoint de autorização. |
| IN\_PROGRESS | Intermediário | A transação está sendo processada pela empresa emissora da fatura. |
| `COMPLETED` | Final | O pagamento foi processado com sucesso. |
| `FAILED` | Final | O pagamento foi rejeitado. Verifique o array errors na resposta. |
| `EXPIRED` | Final | A transação excedeu o limite de tempo de processamento. |
| `REVERSED` | Final | O pagamento foi estornado. |

***

## Catálogo de Tipos de Fatura

O campo `billType` identifica o imposto ou serviço que está sendo pago. O catálogo disponível para o México:

| Código | Descrição |
| - | - |
| 0098 | Impostos federais |

> [!WARNING]
>
> O catálogo de `billType` cresce à medida que novos tipos de impostos e serviços são adicionados. Confirme o catálogo atual com o gerente da sua conta Localpayment antes de entrar em produção com um novo tipo.

***

## Próximos passos

> [card] [Enviar pagamento de imposto, conta ou serviço](https://docs.localpayment.com/pt-br/docs/send-a-bill-payment.md)
>
> Referência da API, exemplos de requisições e respostas e notificações de webhook.

> [card] [Aprovações e dupla assinatura](https://docs.localpayment.com/pt-br/docs/approvals-and-double-signature.md)
>
> Aprenda como autorizar um pagamento criado com requireAuth.


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