Payouts · México
Pagamento de impostos, contas e serviços no México, pela plataforma que você já usa.
Pague impostos federais pela mesma plataforma que você já usa, com a referência de pagamento correspondente, e acompanhe o status de cada pagamento com notificações por webhook.
- México · MXN
- Impostos federais
- Notificações por webhook
México · MXN- 09:41:02.11409:41:02PayIn100 INPROGRESS20084 ms
- 09:41:05.90209:41:05PayIn200 COMPLETED20091 ms
- 09:42:18.33009:42:18PayOut100 INPROGRESS20077 ms
- 09:42:40.01809:42:40PayOut200 COMPLETED20088 ms
- 09:43:00.55109:43:00VirtualAccount200 COMPLETED20080 ms
POST https://example-merchant.com/webhooks/localpayment
x-Signature: HMAC-SHA256 3f9a1c0e…b47e2b
{ "transactionType": "PayIn", "transactionFlow": "DIRECT",
"data": { "externalId": "order_8F2K-1043",
"status": { "code": "200", "description": "COMPLETED" } } }Principais benefícios
Simplifique suas operações de pagamento de impostos no México
O pagamento de impostos, contas e serviços é um método de payout: em vez de enviar fundos para uma conta bancária, você paga uma referência governamental ou de serviços em nome do beneficiário.
Pague impostos federais pela mesma plataforma
Um pagamento de impostos é mais um payout (BillPay, código 0119) na API da Localpayment que você já usa.
Pague com a referência de pagamento
Envie o tipo de imposto e a referência de pagamento correspondente; no México, a referência de pagamento do SAT.
Disponível no México (MEX / MXN)
Para clientes que operam no México, com pagamentos em pesos mexicanos.
Acompanhe o status por webhook
Seu backend recebe o status final de cada pagamento por notificações via webhook.
Como funciona
Da referência de pagamento ao pagamento concluído
- 01
Envie o pagamento
Chame POST /api/payout/ com paymentMethod.type BillPay, e billType e billReference no objeto beneficiary.
- 02
Validação
A Localpayment valida os campos obrigatórios e o catálogo de billType.
- 03
Aprovação (opcional)
Com requireAuth em true, o pagamento fica em PENDING_AUTH até você chamar o endpoint de autorização.
- 04
Pagamento
A Localpayment processa o pagamento com a autoridade fiscal ou o emissor.
- 05
Webhook
A Localpayment atualiza o status da transação e notifica você por webhook.
Status da transação
Cada status do pagamento, claramente definido
PENDING
- Tipo
- Intermediário
- Descrição
- A transação foi recebida e está sendo processada.
PENDING_AUTH
- Tipo
- Intermediário
- Descrição
- requireAuth era true: aguardando você chamar o endpoint de autorização.
IN_PROGRESS
- Tipo
- Intermediário
- Descrição
- A transação está sendo processada pelo emissor.
COMPLETED
- Tipo
- Final
- Descrição
- O pagamento foi processado com sucesso.
FAILED
- Tipo
- Final
- Descrição
- O pagamento foi rejeitado; o array errors da resposta explica o motivo.
EXPIRED
- Tipo
- Final
- Descrição
- A transação excedeu o prazo de processamento.
REVERSED
- Tipo
- Final
- Descrição
- O pagamento foi estornado.
A Localpayment não valida se o valor declarado corresponde ao valor codificado na referência: sua integração declara o valor correto.
Para desenvolvedores
Um pagamento de impostos é um payout com uma referência
Use o endpoint Create a Payout com paymentMethod.type BillPay. Em vez de uma conta bancária, o objeto beneficiary leva o tipo de imposto e a referência oficial.
- paymentMethod.type BillPay, código 0119, fluxo DIRECT
- beneficiary.billType 0098: impostos federais
- beneficiary.billReference: a referência de pagamento do SAT, com 20 caracteres
# Requisição de exemplo no Stage — veja docs.localpayment.com para o contrato completo
curl --request POST \
--url https://api.stage.localpayment.com/api/payout/ \
--header 'Authorization: Bearer <your_access_token>' \
--header 'Content-Type: application/json' \
--data '{
"externalId": "550e8400-e29b-41d4-a716-446655440000",
"country": "MEX",
"currency": "MXN",
"amount": 100.00,
"accountNumber": "<your_account_number>",
"paymentMethod": { "type": "BillPay", "code": "0119", "flow": "DIRECT" },
"beneficiary": { "billType": "0098", "billReference": "20260713000000000001" },
"sender": { "type": "INDIVIDUAL", "name": "Jane", "lastName": "Doe" },
"merchant": { "type": "COMPANY", "name": "Merchant Name" }
}'Perguntas frequentes
Onde está disponível?
No México (MEX), em pesos mexicanos (MXN). Funciona como um payout: a Localpayment envia os fundos para uma referência governamental ou de serviços em nome do beneficiário.
Quais impostos posso pagar hoje?
O catálogo de billType para o México cobre impostos federais (billType 0098). O catálogo cresce à medida que novos tipos de impostos e serviços são adicionados; confirme-o com seu gerente de conta antes de entrar em produção com um tipo novo.
Do que preciso para começar?
Credenciais da API, uma conta dedicada com saldo para pagamentos de impostos e contas, o billType que você vai pagar e a referência de pagamento (no México, a do SAT) fornecida pelo contribuinte ou emissor.
Como acompanho cada pagamento?
A Localpayment notifica o status final ao seu endpoint por webhook, com o externalId, o billType e a billReference. Uma entrega com falha é reenviada até 3 vezes com backoff exponencial, e você sempre pode consultar a transação pela API.
A Localpayment verifica o valor?
Não. Sua integração declara o valor codificado na referência e verifica que ela ainda não foi paga, já que uma referência paga não pode ser reutilizada. Referências do SAT vencidas são rejeitadas depois de validadas junto ao SAT.
Na mesma API
Payouts
Pagamentos para contas bancárias em trilhos locais de 14 países e para carteiras em 9.
Payouts —Conciliação e relatórios
Relatórios, APIs e webhooks para equipes financeiras.
Conciliação e relatórios —Pagamentos no México
Métodos, trilhos e licenças no México.
Pagamentos no México —Guia rápido para desenvolvedores
Obtenha um token, envie sua primeira requisição e receba um webhook no Stage.
Guia rápido para desenvolvedores —
Simplifique suas operações de pagamento de impostos no México
Pague impostos federais pela mesma plataforma que você já usa e acompanhe cada pagamento com notificações por webhook.