Pagamento bollette · Messico
Paga le imposte federali in Messico tramite riferimento, con un’unica API.
BillPay paga i riferimenti della pubblica amministrazione tramite l’API dei payout che già usi. Disponibile oggi in Messico, in MXN, per il pagamento delle imposte federali al SAT.
- Messico · MXN
- Imposte federali SAT
- Doppia firma opzionale
Messico · MXN- Messico, in pesos messicani
- MXN
- Imposte federali, billType 0098
- SAT
- Passaggio di approvazione prima dell’invio di un pagamento
- Opzionale
- A ogni cambio di stato
- Webhook
Perché BillPay
Pagamenti delle imposte dentro il tuo prodotto
I tuoi clienti non dovrebbero lasciare la tua piattaforma per pagare il SAT. BillPay trasforma un riferimento fiscale in un payout in più.
Un’unica integrazione
BillPay è un metodo di payout (tipo BillPay, codice 0119). Se invii già payout, gran parte dell’integrazione è fatta.
Paga tramite riferimento
Invia il tipo di bolletta, il riferimento di pagamento e l’importo. Localpayment paga il riferimento per conto del tuo cliente.
Approvazioni opzionali
Aggiungi requireAuth così un secondo utente autorizzato dà il via libera prima di qualsiasi pagamento.
Stati chiari
Sette stati documentati, da PENDING a COMPLETED, FAILED, EXPIRED o REVERSED.
Pagato da un conto dedicato
I pagamenti vengono addebitati su un conto Localpayment alimentato per il pagamento di imposte e bollette.
Riconciliato con il resto
I pagamenti delle bollette compaiono negli stessi report, nella stessa attività e negli stessi webhook del resto delle tue operazioni.
Come funziona
Dal riferimento fiscale al pagamento, in quattro passaggi
- 01
Invia il riferimento
Chiama POST /api/payout/ con tipo BillPay (codice 0119), billType 0098, la billReference SAT e l’importo.
- 02
Verifica
Localpayment controlla la richiesta e la accetta con il tuo externalId. L’importo è quello dichiarato dalla tua integrazione.
- 03
Approvazione (opzionale)
Con requireAuth, un secondo utente approva nel Business Portal o tramite API prima di qualsiasi invio.
- 04
Pagato + webhook
Il riferimento viene pagato e un webhook firmato segnala COMPLETED, pronto da riconciliare con il resto dei tuoi payout.
Stati
Ogni stato della transazione, definito con chiarezza
Ogni pagamento di bolletta riporta uno dei sette stati, via webhook e tramite l’API di stato delle transazioni.
In attesa (PENDING)
- Significato
- Accettato e in attesa di elaborazione.
In attesa di autorizzazione (PENDING_AUTH)
- Significato
- In attesa di un secondo approvatore (requireAuth).
In corso (IN_PROGRESS)
- Significato
- Il riferimento è in fase di pagamento.
Completato (COMPLETED)
- Significato
- Il riferimento è stato pagato.
Non riuscito (FAILED)
- Significato
- Il pagamento non è andato a buon fine; la risposta ne spiega il motivo.
Scaduto (EXPIRED)
- Significato
- Il pagamento ha superato il tempo limite di elaborazione.
Stornato (REVERSED)
- Significato
- Un pagamento elaborato è stato stornato.
La tua integrazione dichiara l’importo; Localpayment non lo verifica rispetto al riferimento. Descrizioni sintetiche. Consulta la guida BillPay nella documentazione per le definizioni esatte e i codici di errore.
Per chi è
Pensato per le piattaforme al servizio delle imprese messicane
Integra il pagamento delle imposte federali dove i tuoi clienti già gestiscono il loro denaro ed elimina il passaggio in cui lasciano il tuo prodotto per pagare.
- Software di contabilità, paghe ed ERP: paga le imposte federali direttamente dal tuo prodotto
- Fintech e wallet aziendali: permetti agli utenti di pagare il SAT dal proprio saldo
- Fornitori di servizi alle imprese: automatizza i pagamenti fiscali delle aziende che gestisci
Panoramica
USD
1.284.560,00
+4,2%
BRL
3.420.118,40
+12,8%
MXN
8.905.332,10
+6,1%
- Incasso · Pixorder_8F2K-1043+ R$ 1.250,00
- Payout · SPEIseller_0921− MX$ 18.400,00
- Cambio · BRL → USDfx_3b7q250.000,00 USD
- Incasso · Bre-Border_9A1C-2210+ COP 890.000
Per gli sviluppatori
Un pagamento di bolletta è un payout con un riferimento
Usa l’endpoint Create Payout con il metodo BillPay e i dati della bolletta del beneficiario. Autenticati con un token Bearer e ricevi l’esito tramite webhook firmato.
- paymentMethod.type BillPay, codice 0119
- beneficiary.billType 0098 (imposte federali, SAT) e billReference
- requireAuth opzionale per una seconda approvazione
# Richiesta illustrativa — consulta docs.localpayment.com per il contratto esatto
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": "Nortia Commerce S.A. de C.V." },
"merchant": { "type": "COMPANY", "name": "<your-company-name>" }
}'Casi d’uso
Chi paga le imposte tramite API
Fintech e wallet
Permetti agli utenti business di pagare riferimenti SAT dal saldo del wallet.
Fintech e wallet —SaaS
Piattaforme contabili ed ERP che dichiarano e pagano le imposte per i propri clienti.
SaaS —Piattaforme di pagamento
Aggiungi il pagamento delle imposte ai servizi di payout che già offri in Messico.
Piattaforme di pagamento —B2B e alto valore
Paga obblighi fiscali elevati con approvazione a doppia firma.
B2B e alto valore —
Domande frequenti
In quali paesi è disponibile BillPay?
BillPay è disponibile in Messico, in MXN. Se ti servono pagamenti di bollette o imposte in un altro mercato, parla con il nostro team del tuo caso d’uso.
Quali bollette posso pagare?
Oggi il catalogo billType copre le imposte federali versate al SAT (billType 0098).
Cosa devo inviare?
Il tipo di bolletta, il riferimento di pagamento e l’importo, insieme ai campi standard del payout come il tuo externalId e il numero di conto.
È un’integrazione separata?
No. BillPay è un metodo di pagamento dell’API dei payout, quindi usa la stessa autenticazione, gli stessi stati, webhook e report degli altri payout.
Posso aggiungere un passaggio di approvazione?
Sì. Invia il pagamento con requireAuth: resterà in PENDING_AUTH finché un secondo utente autorizzato non lo approva.
Come faccio a sapere che il pagamento è andato a buon fine?
Ricevi un webhook firmato a ogni cambio di stato e puoi interrogare l’API di stato delle transazioni in qualsiasi momento con il tuo externalId.
In quale valuta vengono pagate le imposte?
In pesos messicani (MXN), addebitati da un conto Localpayment in Messico alimentato per il pagamento di imposte e bollette. Alimentalo con incassi locali o un Wire In e usa il cambio per convertire da una valuta forte quando serve.
Ci sono limiti di importo?
Il minimo è MXN 0,01 e non c’è un importo massimo. L’importo inviato deve corrispondere a quello indicato nel riferimento.
Anche sulla stessa API
Payout
Payout su conti bancari tramite circuiti locali in 14 paesi e su wallet in 9.
Payout —Business Portal
Controlla, approva e segui ogni pagamento in un unico posto.
Business Portal —Riconciliazione e reportistica
Report, API e webhook per i team finance.
Riconciliazione e reportistica —Copertura
Presenza autorizzata, registrata o vigilata in 18 paesi e circuiti locali in 14, paese per paese.
Copertura —Directory dei metodi di pagamento
Ogni metodo documentato, con codici, limiti e velocità per paese.
Directory dei metodi di pagamento —Quickstart per sviluppatori
Ottieni un token, invia la prima richiesta e ricevi un webhook su Stage.
Quickstart per sviluppatori —
Automatizza i pagamenti delle imposte in Messico
Aggiungi BillPay alla tua integrazione dei payout e lascia che i tuoi clienti paghino il SAT senza uscire dal tuo prodotto.