Pular para o conteúdo principal
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.

Escopo

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 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 abaixo).

Fluxo de pagamento

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

Estados de transação


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

Enviar pagamento de imposto, conta ou serviço

Referência da API, exemplos de requisições e respostas e notificações de webhook.

Aprovações e dupla assinatura

Aprenda como autorizar um pagamento criado com requireAuth.
Última modificação em 10 de novembro de 2026