Pagamento de impostos · México
Pague impostos federais no México por referência, com uma única API.
O BillPay paga referências governamentais pela API de payouts que você já usa. Disponível hoje no México, em MXN, para o pagamento de impostos federais ao SAT.
- México · MXN
- Impostos federais do SAT
- Dupla assinatura opcional
México · MXN- México, em pesos mexicanos
- MXN
- Impostos federais, billType 0098
- SAT
- Etapa de aprovação antes de enviar um pagamento
- Opcional
- A cada mudança de status
- Webhook
Por que BillPay
Pagamento de impostos dentro do seu produto
Seus clientes não deveriam sair da sua plataforma para pagar o SAT. O BillPay transforma uma referência de imposto em mais um payout.
Uma única integração
O BillPay é um método de payout (tipo BillPay, código 0119). Se você já envia payouts, a maior parte da integração está pronta.
Pagamento por referência
Envie o tipo de cobrança, a referência e o valor. A Localpayment paga a referência em nome do seu cliente.
Aprovações opcionais
Adicione requireAuth para que um segundo usuário autorizado aprove antes de qualquer pagamento.
Status claros
Sete status documentados, de PENDING a COMPLETED, FAILED, EXPIRED ou REVERSED.
Pago de uma conta dedicada
Os pagamentos são debitados de uma conta Localpayment abastecida para pagamentos de impostos e contas.
Conciliado com o resto
Os pagamentos aparecem nos mesmos relatórios, extratos e webhooks do restante das suas operações.
Como funciona
Da referência ao pagamento, em quatro passos
- 01
Envie a referência
Chame POST /api/payout/ com o tipo BillPay (código 0119), billType 0098, a billReference do SAT e o valor.
- 02
Validação
A Localpayment verifica a requisição e a aceita com o seu externalId. O valor é o que a sua integração declara.
- 03
Aprovação (opcional)
Com requireAuth, um segundo usuário aprova no Business Portal ou via API antes do envio.
- 04
Pago + webhook
A referência é paga e um webhook assinado informa COMPLETED, pronto para conciliar com o restante dos seus payouts.
Status
Cada status da transação, claramente definido
Cada pagamento informa um de sete status, por webhook e pela API de status de transações.
Pendente (PENDING)
- O que significa
- Aceito e aguardando processamento.
Aguardando autorização (PENDING_AUTH)
- O que significa
- Aguardando um segundo aprovador (requireAuth).
Em processamento (IN_PROGRESS)
- O que significa
- A referência está sendo paga.
Concluído (COMPLETED)
- O que significa
- A referência foi paga.
Falhou (FAILED)
- O que significa
- Não foi possível concluir o pagamento; a resposta explica o motivo.
Expirado (EXPIRED)
- O que significa
- O pagamento excedeu o tempo limite de processamento.
Estornado (REVERSED)
- O que significa
- Um pagamento processado foi estornado.
Sua integração declara o valor; a Localpayment não o valida em relação à referência. Descrições resumidas. Consulte o guia do BillPay na documentação para as definições exatas e os códigos de erro.
Para quem é
Feito para plataformas que atendem empresas mexicanas
Incorpore o pagamento de impostos federais onde seus clientes já gerenciam o dinheiro e elimine a etapa em que eles saem do seu produto para pagar.
- Softwares contábeis, de folha e ERP: pague impostos federais de dentro do seu produto
- Fintechs e carteiras empresariais: permita pagar o SAT com o saldo da conta
- Prestadores de serviços empresariais: automatize o pagamento de impostos das empresas que você atende
Visão geral
USD
1.284.560,00
+4,2%
BRL
3.420.118,40
+12,8%
MXN
8.905.332,10
+6,1%
- Pay-in · Pixorder_8F2K-1043+ R$ 1.250,00
- Payout · SPEIseller_0921− MX$ 18.400,00
- Câmbio · BRL → USDfx_3b7q250.000,00 USD
- Pay-in · Bre-Border_9A1C-2210+ COP 890.000
Para desenvolvedores
Um pagamento de imposto é um payout com referência
Use o endpoint Create Payout com o método BillPay e os dados de cobrança do beneficiário. Autentique com um token Bearer e receba o resultado por webhook assinado.
- paymentMethod.type BillPay, código 0119
- beneficiary.billType 0098 (impostos federais, SAT) e billReference
- requireAuth opcional para uma segunda aprovação
# Requisição ilustrativa: veja docs.localpayment.com para o contrato exato
curl -X POST https://api.stage.localpayment.com/api/payout/ \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"externalId": "9a7e5c3b-0000-4000-8000-000000000119",
"paymentMethod": { "type": "BillPay", "code": "0119", "flow": "DIRECT" },
"country": "MEX",
"currency": "MXN",
"amount": 12500.00,
"accountNumber": "<your-account-number>",
"requireAuth": true,
"beneficiary": { "billType": "0098", "billReference": "0426ABCD12345678901X" },
"sender": { "type": "COMPANY", "name": "Empresa Exemplo S.A. de C.V." },
"merchant": { "type": "COMPANY", "name": "<your-company-name>" }
}'Casos de uso
Quem paga impostos pela API
Fintechs e carteiras
Permita que usuários empresariais paguem referências do SAT com o saldo da carteira.
Fintechs e carteiras —SaaS
Plataformas contábeis e ERPs que declaram e pagam impostos para seus clientes.
SaaS —Plataformas de pagamento
Adicione pagamento de impostos aos serviços de pagamento que você já oferece no México.
Plataformas de pagamento —B2B e alto valor
Pague obrigações fiscais de alto valor com aprovação por dupla assinatura.
B2B e alto valor —
Perguntas frequentes
Em quais países o BillPay está disponível?
O BillPay está disponível no México, em MXN. Se você precisa de pagamento de contas ou impostos em outro mercado, fale com nossa equipe sobre o seu caso de uso.
Quais contas posso pagar?
Hoje, impostos federais do SAT (billType 0098).
Quais dados preciso enviar?
O tipo de cobrança, a referência e o valor, junto com os campos padrão de um payout, como seu externalId e seu número de conta.
É uma integração separada?
Não. O BillPay é um método de pagamento da API de payouts e usa a mesma autenticação, status, webhooks e relatórios dos seus outros payouts.
Posso adicionar uma etapa de aprovação?
Sim. Envie o pagamento com requireAuth e ele fica em PENDING_AUTH até que um segundo usuário autorizado o aprove.
Como sei que o pagamento foi feito?
Você recebe um webhook assinado quando o status muda e pode consultar a API de status de transações a qualquer momento com o seu externalId.
Em qual moeda os impostos são pagos?
Em pesos mexicanos (MXN), debitados de uma conta Localpayment no México abastecida para pagamentos de impostos e contas. Abasteça-a com recebimentos locais ou um Wire In e use câmbio para converter de uma moeda forte quando necessário.
Existem limites de valor?
O mínimo é MXN 0,01 e não há valor máximo. O valor enviado deve coincidir com o da referência.
Na mesma API
Payouts
Pagamentos para contas bancárias em trilhos locais de 14 países e para carteiras em 9.
Payouts —Business Portal
Revise, aprove e acompanhe cada pagamento em um só lugar.
Business Portal —Conciliação e relatórios
Relatórios, APIs e webhooks para equipes financeiras.
Conciliação e relatórios —Cobertura
Presença licenciada, registrada ou supervisionada em 18 países, com trilhos locais em 14. Veja país por país.
Cobertura —Diretório de métodos de pagamento
Todos os métodos documentados, com códigos, limites e prazos por país.
Diretório de métodos de pagamento —Guia rápido para desenvolvedores
Obtenha um token, envie sua primeira requisição e receba um webhook no Stage.
Guia rápido para desenvolvedores —
Automatize o pagamento de impostos no México
Adicione o BillPay à sua integração de payouts e deixe seus clientes pagarem o SAT sem sair do seu produto.