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
billTypevalidado para os tipos de imposto ou serviço que você pretende pagar (consulte o Catálogo de Tipos de Fatura abaixo).
Fluxo de pagamento
- Você envia uma requisição para
POST /api/payout/compaymentMethod.typedefinido comoBillPay, incluindobillTypeebillReferenceno objetobeneficiary. - A Localpayment valida os campos obrigatórios e o catálogo de
billType. - Se
requireAuthfortrue, a transação permanece emPendingAuthaté que você chame o endpoint de autorização. - A Localpayment processa o pagamento junto à autoridade tributária ou ao emissor da fatura.
- 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 campobillType identifica o imposto ou serviço que está sendo pago. O catálogo disponível para o México:
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.

