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, Diners Club, Naranja e Cabal dove documentato. Tokenizza le carte salvate, autentica con 3D Secure, offri pagamenti rateali e gestisci i chargeback con un’unica integrazione.

Parla con il team commerciale Documentazione carte

Argentina · Colombia · Messico · Perù
Visa, Mastercard, Amex, Diners, Naranja, Cabal
PEN e USD in Perù

PCI DSS v4.0.1
SOC 2 Type II
ISO 27001
AML/KYC
TLS 1.2+ · AES-256

Paesi: Argentina, Colombia, Messico e Perù: 4
Marchi di carte: Visa, Mastercard, Amex, Diners, Naranja e Cabal: 6
In Colombia, Messico e Perù: 3D Secure
In Colombia, Messico e Perù: Pagamenti rateali

Circuiti

Circuiti internazionali e le carte locali che gli acquirenti usano

Visa e Mastercard in tutti e quattro i mercati, più American Express, Naranja e Cabal in Argentina e American Express e Diners Club in Colombia, di credito e di debito.

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
✓

Paese	Una tantum	Tokenizzazione	Rimborsi	Chargeback	3DS	Rateale	Abbonamenti
Argentina	✓	✓	✓	✓	—	—	—
Colombia	✓	✓	✓	✓	✓	✓	✓
Messico	✓	✓	✓	✓	✓	✓	✓
Perù	✓	✓	✓	✓	✓	✓	✓

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

Tokenizzazione e carta salvata
Sostituisci i dati della carta con un token per clienti abituali, acquisti ripetuti più rapidi e abbonamenti.
3D Secure
Autenticazione forte del cliente in Colombia, Messico e Perù. Quando l’emittente richiede una challenge, l’API restituisce l’URL della challenge.
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.
Gestione dei chargeback
Ricevi i webhook di chargeback e carica le prove tramite API entro la finestra di risposta.

Rischio

3D Secure, allow-list dei BIN e gestione dei chargeback

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.

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

Scopri Checkout e Smart Fields

POST /api/payin/

curl -X POST https://api.stage.localpayment.com/api/payin/
  -H "Authorization: Bearer $ACCESS_TOKEN"
  -d '{
    "externalId": "order-8f2k-1043",
    "paymentMethod": { "type": "BankTransfer", "code": "1314" },
    "country": "BRA", "currency": "BRL",
    "amount": 1250.00
  }'

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.

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

Guida ai pagamenti con carta

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

Casi d’uso

Programmi carte per settore

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, Naranja e Cabal in Argentina e American Express e Diners Club in 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.

Accetta pagamenti con carta con un flusso di checkout pensato per ogni mercato.

Circuiti internazionali e le carte locali che gli acquirenti usano

Argentina

Colombia

Messico

Perù

Cosa è disponibile in ogni paese

Tutto ciò che serve per accettare carte

Tokenizzazione e carta salvata

3D Secure

Pagamenti rateali

Preautorizzazione e capture

Rimborsi

Gestione dei chargeback

3D Secure, allow-list dei BIN e gestione dei chargeback

3D Secure

Allow-list dei BIN

Gestione dei chargeback

Tieni i dati delle carte lontani dai tuoi server

Come funziona un pagamento con carta

Acquisizione

Autorizzazione

Autenticazione se necessaria

Conferma

Addebita una carta tokenizzata

Programmi carte per settore

E-commerce e marketplace

SaaS

Beni digitali e streaming

Viaggi

Domande frequenti

Anche sulla stessa API

Checkout

Pagamenti ricorrenti

Incassi

Copertura

Directory dei metodi di pagamento

Esperienze di checkout

Quickstart per sviluppatori

Accetta le carte alla maniera locale