Metodi di pagamento locali
Fai spazio ai metodi di pagamento per cui i clienti aprono già la loro app bancaria.
Bonifici account-to-account e codici QR approvati nell’home banking o nell’app del pagatore, più Wallet Fri in Guatemala. Nessun dato di carta da raccogliere, e ogni stato finale arriva tramite webhook firmato.
- Pix · PSE · Debin · ETPAY
- QR dove è offerto e Wallet Fri
- Un’unica integrazione per tutti i metodi
Pix · PSE · Debin · ETPAY- Pix · PSE
- Pagamenti account-to-account in Brasile e Colombia
- Pix · SPEI
- Circuiti di pagamento locali, in tempo reale, 24/7
- Debin · ETPAY
- Pagamenti bancari in Argentina e Cile
- Wallet Fri
- Pagamenti con wallet in Guatemala
Perché Localpayment
Fai pagare più acquirenti, senza carta
I metodi che le persone usano già
Pix, PSE, Debin, ETPAY, QR e Wallet Fri, approvati nell’home banking o nell’app del pagatore.
Nessun dato di carta da raccogliere
Il pagatore approva fuori dal tuo checkout, così nessun dato di carta passa dai tuoi sistemi.
Un’unica integrazione per tutti i metodi
Tutti i metodi usano la stessa richiesta: cambi metodo, paese e valuta, il resto resta uguale.
Riconciliati come tutto il resto
Monitoriamo l’attesa e ti avvisiamo una sola volta con uno stato finale firmato, nello stesso formato di report di carte e conti virtuali.
Parla con il nostro team commerciale
Raccontaci i tuoi mercati e volumi: progettiamo l’integrazione insieme a te.
Metodi
Circuiti A2A, QR e wallet, mercato per mercato
Ogni metodo segue regole e limiti locali. La tua integrazione resta la stessa.
A2A
- br
- co
- ar
- cl
Pix in Brasile, PSE in Colombia, Debin in Argentina ed ETPAY in Cile. Il pagatore approva con la propria banca.
A2A —QR
- ar
- bo
- gt
- pe
Codici QR in Argentina, Bolivia, Guatemala (QR Fri) e Perù. Il pagatore scansiona e approva nella sua app bancaria o wallet.
QR —Wallet
- gt
Wallet Fri in Guatemala. Il pagatore riceve una notifica push nell’app Wallet Fri e autorizza lì il pagamento; lo stato finale arriva via webhook.
Wallet —
br
co
ar
cl
bo
gt
peCasi d’uso
Dove i metodi locali fanno la differenza
E-commerce e marketplace
Offri Pix, PSE e QR accanto alle carte, così più acquirenti possono pagare come preferiscono.
E-commerce e marketplace —Beni digitali e gaming
Conferma rapida per ricariche e acquisti in-game, senza bisogno di carta.
Beni digitali e gaming —Fintech e wallet
Permetti agli utenti di ricaricare il saldo dall’app della banca, in pochi secondi con circuiti in tempo reale come Pix.
Fintech e wallet —Viaggi
Incassa le prenotazioni in valuta locale con metodi nativi delle banche.
Viaggi —
Come funziona
Quattro passaggi, un unico endpoint
- 01
Crea l’incasso
Chiama POST /api/payin/ e scegli il codice del metodo, ad esempio 1314 per Pix o 1936 per PSE.
- 02
Mostra il QR o reindirizza
Mostra il codice QR o le istruzioni di pagamento, oppure invia il pagatore al flusso bancario per PSE.
- 03
Il pagatore approva
L’approvazione avviene nell’home banking o nell’app del pagatore. Nessun dato di carta passa dal tuo checkout.
- 04
Stato via webhook
Lo stato finale arriva in modo asincrono, firmato con HMAC-SHA256.
Elenco
Metodi locali per paese
Metodi A2A e QR, più Wallet Fri, documentati oggi.
Argentina
- Metodi locali
- QR · Debin
Bolivia
- Metodi locali
- QR
Brasile
- Metodi locali
- Pix
Cile
- Metodi locali
- ETPAY
Colombia
- Metodi locali
- PSE
Guatemala
- Metodi locali
- QR Fri · Wallet Fri
Perù
- Metodi locali
- QR
Fonte: guide per paese su docs.localpayment.com. In Colombia, Bre-B si incassa tramite conti virtuali (chiave Bre-B). La disponibilità viene confermata per ogni merchant durante l’onboarding.
Operatività
Asincrono per progettazione, riconciliato come tutto il resto
I metodi locali confermano quando il pagatore approva, non quando invii la richiesta. Noi monitoriamo l’attesa e ti avvisiamo una sola volta, con uno stato finale firmato.
- Webhook firmati con X-Signature: HMAC-SHA256
- Annullamento dei pagamenti in sospeso prima dell’approvazione del pagatore
- Rimborsi per i pagamenti APM
- Un unico formato di report insieme a carte e conti virtuali
- 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" } } }Playground API
Pix dinamico in un payin
POST /api/payin/ con codice 1314 restituisce il QR dinamico e Copia e Cola. Invio mostra 100 INPROGRESS e poi il webhook.
La barra 80/20 è una ripartizione illustrativa dello storyboard.
Saldi illustrativi
- USD25,000.00
- ARS250,000.00
- BRL184,200.00
- MXN310,500.00
I saldi si muovono solo in questa demo, con gli importi di esempio.
us
pa
svUSD in questa demo: Stati Uniti, Panama, Perù ed El Salvador.
POST /api/payin/
Authorization: Bearer <DEMO_TOKEN>
DEMO · Non viene inviato nulla. Questa demo non chiama Stage né la produzione.
POST /api/payin/
La risposta simulata compare qui
Per sviluppatori
Aggiungi PSE con la stessa richiesta
Cambia paese, valuta e paymentMethod.code: il resto della richiesta rimane uguale. PSE usa un flusso con reindirizzamento e la risposta include l’URL del portale bancario del pagatore.
- Pix 1314 · PSE 1936 · ogni metodo si seleziona con il suo codice
- Get Available Payment Methods per creare un checkout dinamico
- Annulla i pagamenti in sospeso o rimborsa tramite API
# Esempio illustrativo: PSE (Colombia), campi semplificati; vedi docs.localpayment.com 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": "1936", "flow": "REDIRECT" }, "externalId": "c2b8e6d4-0000-4000-8000-000000000019", "country": "COL", "currency": "COP", "amount": 350000, "accountNumber": "<your-account-number>", "conceptCode": "0001", "merchant": { "type": "COMPANY", "name": "Comercio Ejemplo S.A.S.", "merchantId": "<your-merchant-id>" }, "payer": { "type": "INDIVIDUAL", "name": "Camila", "lastname": "Rojas", "document": { "type": "CC", "id": "1000000000" }, "email": "camila.rojas@example.com" } }'
// Esempio illustrativo: PSE (Colombia), campi semplificati; vedi docs.localpayment.com const res = await fetch('https://api.stage.localpayment.com/api/payin/', { method: 'POST', headers: { Authorization: `Bearer ${accessToken}`, // from POST /api/token/ 'Content-Type': 'application/json', }, body: JSON.stringify({ paymentMethod: { type: 'BankTransfer', code: '1936', flow: 'REDIRECT' }, // PSE · Colombia externalId: crypto.randomUUID(), country: 'COL', currency: 'COP', amount: 350000, accountNumber: process.env.LP_ACCOUNT_NUMBER, conceptCode: '0001', merchant: { type: 'COMPANY', name: 'Comercio Ejemplo S.A.S.', merchantId: process.env.LP_MERCHANT_ID }, payer: { type: 'INDIVIDUAL', name: 'Camila', lastname: 'Rojas', document: { type: 'CC', id: '1000000000' }, email: 'camila.rojas@example.com', }, }), }); const payin = await res.json(); // Reindirizza il pagatore a payin.redirectUrl; lo stato finale arriva tramite webhook.
Domande frequenti
Che cos’è un APM?
I metodi di pagamento alternativi sono circuiti locali nativi del sistema bancario: bonifici istantanei, schemi QR e flussi account-to-account. Il pagatore completa il pagamento nella propria app bancaria o wallet, senza inserire dati di carta.
In quanto tempo vengono confermati i pagamenti?
Pix conferma in pochi secondi, 24/7. Gli APM sono asincroni: il pagatore approva fuori dal tuo checkout e ogni stato finale arriva via webhook.
Posso annullare o rimborsare un pagamento APM?
Sì. I pagamenti in sospeso possono essere annullati prima dell’approvazione del pagatore e i pagamenti APM completati possono essere rimborsati.
Per quanto tempo è valida una richiesta Debin?
In Argentina le richieste Debin scadono dopo due giorni se il pagatore non le approva.
Mi serve una nuova integrazione per ogni metodo?
No. Tutti i metodi usano lo stesso endpoint Create Payin; cambi il codice del metodo, il paese e la valuta.
Come completa il pagatore un pagamento APM?
A seconda del metodo, viene reindirizzato alla sua banca (PSE), scansiona un codice QR o approva una richiesta nella sua app bancaria o in Wallet Fri. La pagina delle esperienze di checkout mostra ogni flusso schermata per schermata.
In quale valuta avviene il pagamento?
Nella valuta locale di ogni paese (ad esempio BRL per Pix, COP per PSE e CLP per ETPAY) e viene accreditato sul tuo conto Localpayment nella tua valuta di regolamento.
Anche sulla stessa API
Incassi
Carte, conti virtuali, metodi locali e abbonamenti tramite un solo endpoint Create Payin.
Incassi —Conti virtuali
Un numero di conto locale dedicato per ogni cliente o fattura.
Conti virtuali —Payout
Devi pagare verso wallet? Invia fondi a Yape, SINPE Móvil, wallet CCE e altro ancora.
Payout —Directory dei metodi di pagamento
Ogni metodo documentato, con codici, limiti e velocità per paese.
Directory dei metodi di pagamento —Esperienze di checkout
Guarda come il pagatore vede ogni metodo, schermata per schermata.
Esperienze di checkout —Quickstart per sviluppatori
Ottieni un token, invia la prima richiesta e ricevi un webhook su Stage.
Quickstart per sviluppatori —
Offri i metodi preferiti in America Latina
Individua con il nostro team pagamenti i metodi locali giusti per ciascuno dei tuoi mercati.