Carte
Accetta pagamenti con carta con un flusso di checkout pensato per ogni mercato.
Accetta Visa e Mastercard in Argentina, Colombia, Messico e Perù, più American Express e Diners Club dove documentato. Tokenizza le carte salvate, autentica con 3D Secure, offri pagamenti rateali e gestisci i chargeback con un’unica integrazione.
- PCI DSS v4.0.1
- SOC 2 Type II
- ISO 27001
- AML/KYC
- TLS 1.2+ · AES-256
- Argentina · Colombia · Messico · Perù
- Visa, Mastercard, Amex, Diners
- PEN e USD in Perù
Argentina · Colombia · Messico · Perù- Pix · SPEI
- Circuiti di pagamento locali, in tempo reale, 24/7
- 4
- Marchi di carte: Visa, Mastercard, Amex e Diners
- 3D Secure
- In Colombia, Messico e Perù
- Pagamenti rateali
- In Colombia, Messico e Perù
Perché Localpayment
Converti più pagamenti con carta, con meno rischi
Acquisti ripetuti più rapidi
Sostituisci i dati della carta con un token nei quattro mercati: i clienti abituali pagano più in fretta e gli abbonamenti vengono addebitati sulla carta salvata.
Scontrini più alti con le rate
Permetti ai clienti di pagare a rate con carta di credito, in valuta locale, in Colombia, Messico e Perù.
Meno frodi
3D Secure in Colombia, Messico e Perù, allow-list dei BIN e gestione dei chargeback bloccano le transazioni sospette prima che diventino chargeback.
Perimetro PCI ridotto
Smart Fields, l’iframe incorporato e WebCheckout acquisiscono i dati della carta in campi ospitati da noi, così i dati grezzi non arrivano mai ai tuoi server.
Perimetro PCI ridotto —
Parla con il nostro team commerciale
Raccontaci i tuoi mercati e volumi: progettiamo l’integrazione insieme a te.
Circuiti
I circuiti internazionali che gli acquirenti usano già
Visa e Mastercard in tutti e quattro i mercati, più American Express e Diners Club in Argentina e Colombia, di credito e di debito.
Argentina
- ar
Credito: Visa, Mastercard, American Express e Diners Club. Debito: Visa Debit, Mastercard Debit e Maestro.
Argentina —Colombia
- co
Credito: Visa, Mastercard, American Express e Diners Club. Debito: Visa e Mastercard.
Colombia —Messico
- mx
Credito e debito: Visa e Mastercard.
Messico —Perù
- pe
Credito e debito: Visa e Mastercard, con addebito in PEN o USD.
Perù —
ar
co
mx
peCasi d’uso
Programmi carte per settore
E-commerce e marketplace
Le rate in Colombia, Messico e Perù aumentano la conversione sugli importi elevati.
E-commerce e marketplace —SaaS
Tokenizza una volta e addebita gli abbonamenti con tentativi configurabili.
SaaS —Beni digitali e streaming
Riacquisti con un clic su token salvati, con 3D Secure dove disponibile.
Beni digitali e streaming —Viaggi
Accetta le carte locali che l’acquiring internazionale non raggiunge.
Viaggi —
Come funziona
Come funziona un pagamento con carta
- 01
Acquisizione
Il cliente inserisce i dati della carta in Smart Fields o in un checkout ospitato, oppure riutilizzi un token salvato.
- 02
Autorizzazione
Chiama POST /api/payin/ con paymentMethod.type CreditCard e il codice del circuito per il paese.
- 03
Autenticazione se necessaria
Se l’emittente richiede 3D Secure, reindirizza il cliente all’URL della challenge indicato nella risposta.
- 04
Conferma
Il risultato arriva in tempo reale e tramite webhook firmato, pronto per l’evasione dell’ordine e la riconciliazione.
Mercato per mercato
Cosa è disponibile in ogni paese
Le funzionalità delle carte variano in base al mercato. Ecco cosa copre oggi la documentazione.
Argentina
- Una tantum
- ✓
- Tokenizzazione
- ✓
- Rimborsi
- ✓
- Chargeback
- ✓
- 3DS
- —
- Rateale
- —
- Abbonamenti
- —
Colombia
- Una tantum
- ✓
- Tokenizzazione
- ✓
- Rimborsi
- ✓
- Chargeback
- ✓
- 3DS
- ✓
- Rateale
- ✓
- Abbonamenti
- ✓
Messico
- Una tantum
- ✓
- Tokenizzazione
- ✓
- Rimborsi
- ✓
- Chargeback
- ✓
- 3DS
- ✓
- Rateale
- ✓
- Abbonamenti
- ✓
Perù
- Una tantum
- ✓
- Tokenizzazione
- ✓
- Rimborsi
- ✓
- Chargeback
- ✓
- 3DS
- ✓
- Rateale
- ✓
- Abbonamenti
- ✓
Fonte: docs.localpayment.com. Le carte non sono disponibili in Brasile: usa Pix e i conti virtuali con chiave Pix.
Funzionalità
Tutto ciò che serve per accettare carte
Controlli su più livelli ti aiutano a bloccare le transazioni fraudolente prima che diventino chargeback.
3D Secure
Autentica i titolari di carta in Colombia, Messico e Perù. Quando l’emittente richiede la challenge, l’API restituisce l’URL della challenge.
Allow-list dei BIN
Limita l’accettazione ai BIN preapprovati, per emittente e tipo di carta, dal Business Portal.
Gestione dei chargeback
Ricevi un webhook per ogni chargeback e carica le prove tramite l’API o il Business Portal entro la scadenza.
Pagamenti rateali
Calcola un piano di rate, lascia scegliere il cliente e addebita, con carte di credito in valuta locale in Colombia, Messico e Perù (solo PEN).
Preautorizzazione e capture
Autorizza ora e incassa dopo, oppure sblocca l’importo se l’ordine non va avanti. La disponibilità per mercato viene confermata durante l’onboarding.
Rimborsi
Rimborsa i pagamenti con carta tramite API o Business Portal e scarica la ricevuta di pagamento.
Perimetro PCI
Tieni i dati delle carte lontani dai tuoi server
Raccogli le carte con Smart Fields, l’iframe integrato o WebCheckout. I dati della carta vengono acquisiti in campi ospitati da noi e trasformati in un token che il tuo backend invia con l’incasso.
- Smart Fields: campi carta ospitati nella tua interfaccia, tramite un SDK JS
- Iframe integrato: un checkout white-label con perimetro PCI ridotto
- WebCheckout e link di pagamento: senza codice e con perimetro PCI minimo
- TLS 1.2+ in transito, AES-256 a riposo e rotazione delle chiavi con AWS KMS
Playground API
Addebita una carta tokenizzata
POST /api/payin/ con un token carta in Messico (Visa, codice 1600). Invio mostra 103 APPROVED e poi il webhook di accredito.
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
Addebita una carta tokenizzata
Invia il token al posto dei dati della carta e riutilizzalo per gli addebiti successivi.
- Codici circuito per paese, ad esempio 1600 per Visa in Messico
- Carte di test Stage per approvazioni, rifiuti e 3D Secure
- Webhook per approvazioni, rimborsi e chargeback
# Esempio illustrativo: campi semplificati; consulta docs.localpayment.com per il contratto completo curl -X POST https://api.stage.localpayment.com/api/payin/ \ -H "Authorization: Bearer $ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "paymentMethod": { "type": "CreditCard", "code": "1600", "flow": "DIRECT" }, "externalId": "3f9a6c1e-0000-4000-8000-000000000042", "country": "MEX", "currency": "MXN", "amount": 1250.00, "accountNumber": "<your-account-number>", "conceptCode": "0001", "merchant": { "type": "COMPANY", "name": "Comercio Ejemplo S.A. de C.V." }, "payer": { "type": "INDIVIDUAL", "name": "Lucía", "lastname": "Méndez", "document": { "type": "RFC", "id": "XAXX010101000" }, "email": "lucia.mendez@example.com" }, "card": { "token": "<card-token>" } }'
// Esempio illustrativo: campi semplificati; consulta docs.localpayment.com per il contratto completo 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: 'CreditCard', code: '1600', flow: 'DIRECT' }, // Visa · Mexico externalId: crypto.randomUUID(), country: 'MEX', currency: 'MXN', amount: 1250.0, accountNumber: process.env.LP_ACCOUNT_NUMBER, conceptCode: '0001', merchant: { type: 'COMPANY', name: 'Comercio Ejemplo S.A. de C.V.' }, payer: { type: 'INDIVIDUAL', name: 'Lucía', lastname: 'Méndez', document: { type: 'RFC', id: 'XAXX010101000' }, email: 'lucia.mendez@example.com', }, card: { token: storedCardToken }, // token da POST /api/card o da Smart Fields }), }); const payin = await res.json(); // status.description: APPROVED, REJECTED…
Domande frequenti
Le carte sono disponibili in Brasile?
No. L’accettazione delle carte copre Argentina, Colombia, Messico e Perù. In Brasile incassa con Pix e i conti virtuali con chiave Pix, che confermano in pochi secondi, 24/7.
Quali circuiti di carte posso accettare?
Visa e Mastercard in tutti e quattro i mercati, più American Express e Diners Club in Argentina e Colombia. Le carte di debito sono supportate in tutti e quattro i mercati.
Dove sono disponibili 3D Secure, pagamenti rateali e abbonamenti?
In Colombia, Messico e Perù. Le rate valgono per le carte di credito in valuta locale, quindi in Perù solo per i pagamenti in PEN. In Argentina puoi usare pagamenti una tantum, tokenizzazione, rimborsi e gestione dei chargeback.
Come funzionano i chargeback?
Ricevi un webhook di chargeback e puoi caricare le prove tramite API o Business Portal entro la scadenza indicata nella notifica. Se le prove non arrivano in tempo, la contestazione di solito si risolve a favore del titolare della carta.
Posso testare i flussi con carta prima di andare live?
Sì. Stage fornisce carte di test per approvazioni, rifiuti, challenge 3D Secure ed errori di elaborazione, senza denaro reale.
Come vengono protetti i dati delle carte?
I dati sono cifrati con TLS 1.2+ in transito e AES-256 a riposo, con rotazione delle chiavi tramite AWS KMS. Smart Fields e i checkout ospitati tengono i dati grezzi delle carte lontani dai tuoi server.
Posso salvare le carte per addebiti successivi?
Sì. La tokenizzazione è disponibile in Argentina, Colombia, Messico e Perù. Salvi il token, mai il PAN, e lo addebiti in seguito per riacquisti o abbonamenti.
In quale valuta vengono addebitati i pagamenti con carta?
Le carte vengono addebitate nella valuta locale di ogni mercato (ARS, COP e MXN) e in PEN o USD in Perù, poi accreditate sul tuo conto nella tua valuta di regolamento.
Anche sulla stessa API
Checkout
Campi ospitati, iframe e opzioni no-code che riducono il tuo perimetro PCI.
Checkout —Pagamenti ricorrenti
Abbonamenti con carta e nuovi tentativi configurabili in Colombia, Messico e Perù.
Pagamenti ricorrenti —Incassi
Aggiungi conti virtuali, QR e metodi locali accanto alle carte con lo stesso endpoint.
Incassi —Copertura
Presenza autorizzata, registrata o vigilata in valute locali e circuiti locali, paese per paese.
Copertura —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 —
Accetta le carte alla maniera locale
Parla con il nostro team dell’accettazione carte in Argentina, Colombia, Messico e Perù.