Payout · Messico

Pagamento di imposte, bollette e servizi in Messico, dalla piattaforma che già usi.

Paga le imposte federali dalla stessa piattaforma che già usi, con il riferimento di pagamento corrispondente, e segui lo stato di ogni pagamento con le notifiche webhook.

Parla con il team commerciale Leggi la documentazione

Messico · MXN
Imposte federali
Notifiche webhook

webhooks · consegne

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" } } }

Vantaggi principali

Semplifica le operazioni di pagamento delle imposte in Messico

Il pagamento di imposte, bollette e servizi è un metodo di payout: invece di inviare fondi a un conto bancario, paghi un riferimento della pubblica amministrazione o di un servizio per conto del beneficiario.

Paga le imposte federali dalla stessa piattaforma
Un pagamento di imposte è un payout in più (BillPay, codice 0119) sull’API di Localpayment che già usi.
Paga con il riferimento di pagamento
Invia il tipo di imposta e il riferimento di pagamento corrispondente; in Messico, il riferimento di pagamento del SAT.
Disponibile in Messico (MEX / MXN)
Per i clienti che operano in Messico, con pagamenti in pesos messicani.
Segui lo stato via webhook
Il tuo backend riceve lo stato finale di ogni pagamento tramite notifiche webhook.

Come funziona

Dal riferimento di pagamento al pagamento completato

01
Invia il pagamento
Chiama POST /api/payout/ con paymentMethod.type BillPay, e billType e billReference nell’oggetto beneficiary.
02
Convalida
Localpayment convalida i campi obbligatori e il catalogo billType.
03
Approvazione (facoltativa)
Con requireAuth a true, il pagamento resta in PENDING_AUTH finché non chiami l’endpoint di autorizzazione.
04
Pagamento
Localpayment elabora il pagamento con l’autorità fiscale o l’ente emittente.
05
Webhook
Localpayment aggiorna lo stato della transazione e te lo notifica via webhook.

Stati della transazione

Ogni stato del pagamento, chiaramente definito

PENDING
Tipo
Intermedio
Descrizione
La transazione è stata ricevuta ed è in elaborazione.
PENDING_AUTH
Tipo
Intermedio
Descrizione
requireAuth era true: in attesa che tu chiami l’endpoint di autorizzazione.
IN_PROGRESS
Tipo
Intermedio
Descrizione
La transazione è in elaborazione presso l’ente emittente.
COMPLETED
Tipo
Finale
Descrizione
Il pagamento è stato elaborato correttamente.
FAILED
Tipo
Finale
Descrizione
Il pagamento è stato rifiutato; l’array errors della risposta ne indica il motivo.
EXPIRED
Tipo
Finale
Descrizione
La transazione ha superato il tempo limite di elaborazione.
REVERSED
Tipo
Finale
Descrizione
Il pagamento è stato stornato.

Stato	Tipo	Descrizione
PENDING	Intermedio	La transazione è stata ricevuta ed è in elaborazione.
PENDING_AUTH	Intermedio	requireAuth era true: in attesa che tu chiami l’endpoint di autorizzazione.
IN_PROGRESS	Intermedio	La transazione è in elaborazione presso l’ente emittente.
COMPLETED	Finale	Il pagamento è stato elaborato correttamente.
FAILED	Finale	Il pagamento è stato rifiutato; l’array errors della risposta ne indica il motivo.
EXPIRED	Finale	La transazione ha superato il tempo limite di elaborazione.
REVERSED	Finale	Il pagamento è stato stornato.

Localpayment non verifica che l’importo dichiarato corrisponda a quello codificato nel riferimento: è la tua integrazione a dichiarare l’importo corretto.

Per sviluppatori

Un pagamento di imposte è un payout con un riferimento

Usa l’endpoint Create a Payout con paymentMethod.type BillPay. Invece di un conto bancario, l’oggetto beneficiary contiene il tipo di imposta e il riferimento ufficiale.

paymentMethod.type BillPay, codice 0119, flusso DIRECT
beneficiary.billType 0098: imposte federali
beneficiary.billReference: il riferimento di pagamento SAT di 20 caratteri

Invia un pagamento di imposte, bollette o servizi

# Richiesta di esempio su Stage — vedi docs.localpayment.com per il contratto 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" }
  }'

Domande frequenti

Dove è disponibile?

In Messico (MEX), in pesos messicani (MXN). Funziona come un payout: Localpayment invia i fondi a un riferimento della pubblica amministrazione o di un servizio per conto del beneficiario.

Quali imposte posso pagare oggi?

Il catalogo billType per il Messico copre le imposte federali (billType 0098). Il catalogo cresce con l’aggiunta di nuovi tipi di imposte e servizi; confermalo con il tuo account manager prima di andare in produzione con un nuovo tipo.

Cosa mi serve per iniziare?

Credenziali API, un conto dedicato alimentato per i pagamenti di imposte e bollette, il billType che intendi pagare e il riferimento di pagamento (in Messico, quello del SAT) fornito dal contribuente o dall’ente emittente.

Come seguo ogni pagamento?

Localpayment notifica lo stato finale al tuo endpoint via webhook, con externalId, billType e billReference. Una consegna non riuscita viene ritentata fino a 3 volte con backoff esponenziale, e puoi sempre recuperare la transazione tramite l’API.

Localpayment verifica l’importo?

No. La tua integrazione dichiara l’importo codificato nel riferimento e verifica che il riferimento non sia già stato pagato, perché un riferimento pagato non si può riutilizzare. I riferimenti SAT scaduti vengono rifiutati una volta convalidati presso il SAT.

Anche sulla stessa API

Semplifica le operazioni di pagamento delle imposte in Messico

Paga le imposte federali dalla stessa piattaforma che già usi e segui ogni pagamento con le notifiche webhook.

Parla con il team commerciale Leggi la documentazione

Pagamento di imposte, bollette e servizi in Messico, dalla piattaforma che già usi.

Semplifica le operazioni di pagamento delle imposte in Messico

Paga le imposte federali dalla stessa piattaforma

Paga con il riferimento di pagamento

Disponibile in Messico (MEX / MXN)

Segui lo stato via webhook

Dal riferimento di pagamento al pagamento completato

Invia il pagamento

Convalida

Approvazione (facoltativa)

Pagamento

Webhook

Ogni stato del pagamento, chiaramente definito

Un pagamento di imposte è un payout con un riferimento

Domande frequenti

Anche sulla stessa API

Payout

Riconciliazione e reportistica

Pagamenti in Messico

Quickstart per sviluppatori

Semplifica le operazioni di pagamento delle imposte in Messico

Scarica la tua copia