Incassi
Lascia che i tuoi clienti paghino come si paga già nel loro mercato.
Offri al checkout i metodi di pagamento locali supportati, ricevi la conferma tramite gli aggiornamenti di ogni transazione e collega i fondi in entrata al resto della tua operatività.
- Un endpoint: POST /api/payin/
- Valuta locale, un unico saldo
- Webhook firmati per ogni stato
Un endpoint: POST /api/payin/
- Paesi con incassi
- 9
- Paesi con conti virtuali
- 7
- Paesi con carte: Argentina, Colombia, Messico e Perù
- 4
- Stato in tempo reale per ogni pagamento
- Webhook
La sfida
Gli incassi transfrontalieri lasciano soldi sul tavolo
Le carte internazionali sono solo una parte del quadro. In tutta la regione si paga con bonifico e QR, e ogni paese lo fa in modo diverso.
Incassare senza un partner locale
- Solo carteMolti acquirenti preferiscono bonifico o QR e abbandonano se non li trovano.
- Una nuova integrazione per ogni paeseOgni mercato ha circuiti, documenti, limiti e regole propri.
- Riconciliazione manualeAbbinare a mano i pagamenti di più fornitori è lento e soggetto a errori.
Incassare con Localpayment
- I metodi che le persone usano giàPix, PSE, Bre-B, CVU, CLABE, QR e circuiti di carte locali con un’unica integrazione.
- Uno schema unico per tutti i paesiGli stessi campi ovunque: country, currency, amount, paymentMethod, externalId.
- Un saldo, un report, un formato di webhookOgni incasso viene accreditato sul tuo conto e riconciliato negli stessi report.
Metodi
Metodi locali supportati, un unico endpoint.
Scegli i metodi preferiti da ogni mercato. La struttura della richiesta non cambia mai: cambiano solo il codice del metodo di pagamento, il paese e la valuta.
Carte
- ar
- co
- mx
- pe
Visa e Mastercard in Argentina, Colombia, Messico e Perù, più American Express, Naranja e Cabal in Argentina e American Express e Diners Club in Colombia.
Carte —Conti virtuali
- ar
- br
- cl
- co
- cr
- mx
- pe
Un CVU, una chiave Pix, una CLABE, un CCI, un IBAN, una chiave Bre-B o un numero di conto cileno dedicato per cliente, fattura o ordine.
Conti virtuali —Metodi di pagamento locali (APM)
- ar
- bo
- br
- cl
- co
- gt
- pe
Pix in Brasile, PSE in Colombia, Debin e QR in Argentina, ETPAY in Cile, QR in Bolivia e Perù, e QR Fri e Wallet Fri in Guatemala.
Metodi di pagamento locali (APM) —Abbonamenti
- co
- mx
- pe
Piani programmati o addebiti on demand con nuovi tentativi configurabili.
Abbonamenti —
ar
co
mx
pe
br
cl
cr
bo
gtFlusso di denaro
Dal checkout al tuo saldo
Una richiesta crea il pagamento; il circuito locale lo conferma; un webhook firmato avvisa la tua piattaforma.
- 1
ClienteLa tua piattaforma:
Sceglie un metodo locale
Pix, SPEI, PSE, Bre-B, carte o qualsiasi metodo disponibile nel paese.
- 2
La tua piattaformaLocalpayment:
POST /api/payin/
Importo, valuta, paese e dati del pagatore in una richiesta.
- 3
LocalpaymentCliente:
Istruzioni di pagamento
QR code, chiave, riferimento o reindirizzamento, a seconda del metodo.
- 4
ClienteCircuito locale / banca:
Paga nell’app della banca
Il pagatore autorizza con la propria banca o wallet.
- 5
Circuito locale / bancaLocalpayment:
Il circuito conferma
I circuiti in tempo reale confermano in secondi; gli altri seguono i propri orari di cut-off.
- 6
LocalpaymentLa tua piattaforma:
Webhook firmato
Il tuo sistema rilascia l’ordine e il saldo viene accreditato.
Flusso illustrativo. Tempi di conferma e cut-off dipendono dal metodo e dal paese.
Come funziona
Dalla richiesta al saldo in quattro passaggi
- 01
Richiesta
POST /api/payin/ con paese (ISO-3), valuta, importo, paymentMethod e il tuo externalId univoco.
- 02
Il cliente paga
Le carte vengono autorizzate in tempo reale. I conti virtuali e i metodi di pagamento locali confermano in modo asincrono.
- 03
Webhook
Un webhook firmato HMAC-SHA256 trasmette il risultato, il tuo externalId e il nostro internalId.
- 04
Saldo accreditato
L’incasso viene accreditato sul tuo conto Localpayment nella tua valuta di regolamento, di solito USD.
Ciclo di vita
Gestisci l’intero ciclo di vita del pagamento
Tutto ciò che succede dopo il pagamento avviene sulla stessa piattaforma, tramite API o Business Portal.
- Rimborsi per pagamenti con carta, conto virtuale e APM
- Gestione dei chargeback con caricamento delle prove tramite API
- Annullamento dei pagamenti APM in sospeso prima dell’approvazione del pagatore
- Download delle ricevute di pagamento per i rimborsi
- Checkout dinamici con l’endpoint Get Available Payment Methods
- FX al momento del pagamento, con tasso bloccato tramite quote token
- 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" } } }Per sviluppatori
Un unico endpoint, campi specifici per paese.
Autenticati con POST /api/token/, poi chiama lo stesso endpoint Create Payin per qualsiasi paese, con i campi richiesti da quel paese. Questo esempio Pix restituisce un codice QR e conferma tramite webhook.
- Bearer token: access token da 5 minuti, refresh token da 24 ore
- Il tuo externalId in ogni richiesta; i duplicati restituiscono HTTP 409
- Stage replica la produzione, senza denaro reale
# 1) Ottieni un access token (Stage). Conserva le credenziali in un secrets manager.
curl -X POST https://api.stage.localpayment.com/api/token/ \
-H "Content-Type: application/json" \
-d '{ "username": "<api-user>", "password": "<from-your-secrets-manager>" }'
# 2) Crea un incasso Pix (valori fittizi)
curl -X POST https://api.stage.localpayment.com/api/payin/ \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"paymentMethod": { "type": "BankTransfer", "code": "1314", "flow": "DIRECT" },
"externalId": "7c1e2f7a-0000-4000-8000-000000000001",
"country": "BRA",
"currency": "USD",
"amount": 100,
"accountNumber": "<your-account-number>",
"conceptCode": "0003",
"merchant": { "type": "COMPANY", "name": "Loja Exemplo Ltda" },
"payer": {
"type": "INDIVIDUAL",
"name": "Maria",
"lastname": "Silva",
"document": { "type": "CPF", "id": "000.000.000-00" }
}
}'Copertura
Metodi di incasso per paese
Argentina
- Conti virtuali
- CVU
- Carte
- Sì
- Metodi locali
- QR · Debin
Bolivia
- Conti virtuali
- —
- Carte
- —
- Metodi locali
- QR
Brasile
- Conti virtuali
- Conto virtuale (Pix o TED)
- Carte
- —
- Metodi locali
- Pix
Cile
- Conti virtuali
- Conto bancario (TEF)
- Carte
- —
- Metodi locali
- ETPAY
Colombia
- Conti virtuali
- Chiave Bre-B
- Carte
- Sì
- Metodi locali
- PSE
Costa Rica
- Conti virtuali
- IBAN (SINPE)
- Carte
- —
- Metodi locali
- —
Guatemala
- Conti virtuali
- —
- Carte
- —
- Metodi locali
- QR Fri · Wallet Fri
Messico
- Conti virtuali
- CLABE
- Carte
- Sì
- Metodi locali
- —
Perù
- Conti virtuali
- CCI
- Carte
- Sì
- Metodi locali
- QR
Fonte: guide per paese su docs.localpayment.com. La disponibilità viene confermata per ogni merchant durante l’onboarding.
Casi d’uso
Incassi pensati per ogni settore
E-commerce e marketplace
Carte, Pix, PSE e SPEI al checkout, con rimborsi dalla stessa API.
E-commerce e marketplace —Beni digitali e streaming
I circuiti istantanei confermano in secondi e il contenuto si sblocca subito.
Beni digitali e streaming —SaaS
Incassa gli abbonamenti in locale e regola nella tua valuta forte.
SaaS —Viaggi
Importi elevati via bonifico con conferma in tempo reale.
Viaggi —
Domande frequenti
Qual è la mia valuta di regolamento?
Di solito USD. Gli incassi in valuta locale vengono accreditati sul tuo conto Localpayment nella tua valuta di regolamento. Puoi anche convertire i saldi locali in altre valute forti, come EUR o GBP, negli orari del mercato locale.
I pagamenti vengono confermati in tempo reale?
Le autorizzazioni con carta sono in tempo reale. I circuiti in tempo reale come Pix, SPEI, COELSA, TEF, CCE e Bre-B confermano in pochi secondi, 24/7. Gli altri metodi confermano in modo asincrono e ogni stato finale arriva tramite webhook.
Come so che un pagamento è stato completato?
Ricevi un webhook firmato HMAC-SHA256 nell’header X-Signature. Uno status.code pari a 200 significa COMPLETED. Puoi anche interrogare GET /api/transactions/{externalId}/status.
Posso rimborsare un pagamento?
Sì. I pagamenti con carta, conto virtuale e APM possono essere rimborsati tramite API o Business Portal.
Mi serve un’integrazione separata per ogni paese?
No. La struttura della richiesta è la stessa ovunque; i nuovi mercati si attivano tramite configurazione, senza reintegrazione.
Come inizio i test?
Le credenziali Stage vengono fornite all’inizio della partnership. Stage replica la produzione senza denaro reale, così puoi testare ogni flusso prima di andare live.
Quali metodi di pagamento posso offrire in ogni paese?
Carte in Argentina, Colombia, Messico e Perù, e conti virtuali e metodi di pagamento locali (APM) dove documentati per paese. La directory dei metodi di pagamento elenca ogni metodo, codice e velocità; il tuo account team li abilita per configurazione.
Posso incassare in dollari?
In alcuni mercati sì: per esempio conti virtuali in USD in Costa Rica, Perù e Messico (via SPID). Nella maggior parte dei paesi il pagatore paga in valuta locale e l’incasso viene accreditato sul tuo conto nella tua valuta di regolamento.
Anche sulla stessa API
Conti virtuali
Un numero di conto locale univoco per cliente, riconciliato automaticamente.
Conti virtuali —Payout
Payout su conti bancari tramite circuiti locali in 14 paesi e su wallet in 9.
Payout —Riconciliazione e reportistica
Report, API e webhook per i team finance.
Riconciliazione e reportistica —
Inizia a incassare localmente
Ricevi le credenziali Stage all’inizio della partnership, vai live in poche settimane e apri nuovi mercati tramite configurazione.