Domande frequenti

Localpayment è un’infrastruttura di pagamento per l’America Latina. Con un’unica API e il Business Portal, le aziende incassano pagamenti locali, inviano payout, emettono conti virtuali e convertono valuta in tutta la regione.

Localpayment fa parte di Aleph Group, che unisce pagamenti e media digitali per piattaforme e brand che entrano nei mercati emergenti. Dati come oltre 26.000 inserzionisti, oltre 55 piattaforme e oltre 130 mercati si riferiscono ad Aleph Group nel suo insieme, non alla sola Localpayment.

Entrambe le cose. Orchestriamo i pagamenti con una sola API, e lo facciamo sopra una presenza autorizzata, registrata o vigilata in 18 paesi e circuiti locali in 14, invece di limitarci a instradare verso altri fornitori.

Aziende che incassano o pagano persone in America Latina: e-commerce e marketplace, beni digitali e gaming, fintech e wallet, società di rimesse, SaaS, viaggi, mobilità, buste paga e piattaforme pubblicitarie. Le pagine delle soluzioni mostrano i flussi tipici di ciascuna.

Incassi con metodi di pagamento locali e carte, conti virtuali, pagamenti ricorrenti, checkout ospitato, payout, pagamento di bollette, FX e tesoreria, un conto di tesoreria globale, circuiti stablecoin, smart routing, report e riconciliazione: tutto con una sola API e il Business Portal.

No. Localpayment è un fornitore di servizi di pagamento. In ogni paese abbiamo la licenza, la registrazione o la supervisione che la normativa locale richiede per i pagamenti – istituto di pagamento in Brasile, money transmitter in Messico e così via – e la pagina delle licenze mostra lo stato esatto per tutti i 18 paesi.

La piattaforma enterprise viene quotata azienda per azienda, quindi il volume è solo una delle variabili. Le piccole e medie imprese possono anche richiedere l’accesso anticipato a Localpayment per le PMI, un conto aziendale self-service. Raccontaci i tuoi flussi e ti indicheremo l’opzione giusta.

Abbiamo una presenza autorizzata, registrata o vigilata in 18 paesi, con circuiti di pagamento locali in 14. Metodi di pagamento, valute e licenze variano da paese a paese; le pagine Copertura e Licenze li elencano uno per uno.

Dipende dal paese: pagamenti bancari come Pix in Brasile, SPEI in Messico, Bre-B e PSE in Colombia e Debin in Argentina; pagamenti con QR in Argentina, Bolivia, Guatemala e Perù; conti virtuali in sette paesi; e carte in Argentina, Colombia, Messico e Perù. La directory dei metodi di pagamento li elenca tutti per paese.

No. In Brasile i clienti pagano con Pix, tramite codice QR o Copia e Cola, oppure con bonifico su un conto virtuale identificato da una chiave Pix. Le carte sono disponibili in Argentina, Colombia, Messico e Perù.

Visa e Mastercard in Argentina, Colombia, Messico e Perù, più American Express, Diners Club, Naranja e Cabal in Argentina e American Express e Diners Club in Colombia. 3D Secure, rateizzazione e abbonamenti sono disponibili in Colombia, Messico e Perù.

No. Integri una volta sola e aggiungi mercati con la configurazione, senza reintegrare. Un nuovo paese o metodo di pagamento può richiedere un’ulteriore revisione di compliance.

Le pagine di copertura elencano ogni paese con stato della licenza, valute e circuiti, e la directory dei metodi di pagamento elenca ogni metodo per paese. La disponibilità in tempo reale dei circuiti di ogni paese è pubblicata su status.localpayment.com.

Il nostro catalogo si concentra su pagamenti bancari, QR, conti virtuali e carte: i metodi più usati nella regione per pagare online oggi. Se il tuo caso richiede un’opzione in contanti in un paese specifico, parla con le vendite.

Per gli incassi offriamo metodi QR e di bonifico invece dei wallet: QR interoperabile e bonifici verso CVU in Argentina, Pix in Brasile, QR in Bolivia e Perù, e QR Fri e Wallet Fri in Guatemala. Per i payout, i wallet sono raggiungibili in 9 paesi (Argentina, Bolivia, Brasile, Cile, Colombia, Costa Rica, El Salvador, Messico e Perù): con integrazione diretta in Bolivia, Costa Rica e Perù, e tramite circuiti bancari negli altri.

Sì. Pix in Brasile, SPEI in Messico, Bre-B in Colombia, bonifici COELSA in Argentina, TEF in Cile, CCE in Perù e SINPE Móvil in Costa Rica confermano in pochi secondi, 24 ore su 24, entro i limiti di ciascun circuito.

La copertura cresce di continuo, ma pubblichiamo solo ciò che è operativo oggi. Se ti serve un mercato o un metodo che non è elencato, dillo alle vendite: ci aiuta a dare priorità e possiamo dirti cosa riusciamo a supportare per il tuo caso.

I payout tramite bonifico passano sui circuiti locali di 14 paesi: Argentina, Bolivia, Brasile, Cile, Colombia, Costa Rica, Repubblica Dominicana, El Salvador, Guatemala, Honduras, Messico, Panama, Paraguay e Perù.

Sui circuiti in tempo reale come Pix, SPEI, COELSA, TEF, CCE, Bre-B e SINPE Móvil, i payout si confermano in pochi secondi, 24/7, entro i limiti di ciascun circuito. I circuiti a lotti come ACH o TED accreditano in giornata o il giorno lavorativo successivo, a seconda dei cut-off.

Sì. I payout su wallet raggiungono 9 paesi. L’integrazione diretta con i wallet è disponibile in Bolivia, Costa Rica (SINPE Móvil) e Perù, e i payout tramite bonifico possono raggiungere wallet in Argentina, Bolivia, Brasile, Cile, Colombia, El Salvador e Messico.

Sì. Con la doppia firma, un utente crea un payout e un altro lo autorizza, usando requireAuth nell’API o la coda di approvazione nel Business Portal.

Per ogni payout è disponibile una prova di pagamento tramite l’API e il Business Portal, e ogni cambio di stato, da Pending Authorization a Completed, arriva tramite webhook firmato.

Tramite API, con una richiesta per payout dai tuoi sistemi, oppure caricando un file batch nel Business Portal. Entrambe le vie supportano l’approvazione a doppia firma e riportano lo stato di ogni payout via webhook.

Nome del beneficiario, codice fiscale (CPF o CNPJ, CUIT, RFC, NIT e così via) e identificativo del conto bancario – CBU o CVU, CLABE, chiave Pix, CCI, IBAN o l’equivalente locale – più i campi richiesti dalla normativa di quel paese. L’API valida i formati prima dell’invio.

Se la validazione o la banca lo rifiutano prima dell’invio, ricevi lo stato Rejected con il motivo. Sui circuiti batch la banca del beneficiario può restituire un pagamento giorni dopo; i fondi vengono riaccreditati sul tuo saldo e ricevi una notifica via webhook.

I payout sui circuiti in tempo reale sono definitivi una volta completati. Sugli altri circuiti il richiamo è un processo manuale, best effort, gestito con il supporto e dipende dalla banca ricevente. Validare i dati del beneficiario e usare la doppia firma è la protezione migliore.

Sì. I payout vengono addebitati sul tuo saldo Localpayment, che alimenti con un Wire In in valuta forte o stablecoin, oppure con i proventi dei tuoi incassi, secondo il tuo contratto.

Persone e aziende: fornitori, venditori, creator, autisti e corrieri, lavoratori autonomi, beneficiari di rimesse e utenti di wallet che prelevano il saldo. I payout sono sempre in valuta locale su circuiti locali.

Le valute locali si convertono in valute forti: USD, EUR, GBP, CAD, AUD, NZD e CHF, oltre alle stablecoin USDC e USDT. Le conversioni vanno dalla valuta locale a quella forte.

Durante l’orario di ciascun mercato locale, che varia da paese a paese: per esempio 10:00–12:30 in Brasile e 08:00–15:30 in Messico, ora locale. La conversione non è disponibile 24 ore su 24; la documentazione indica gli orari di ogni paese.

Sì. Richiedi una quotazione e ricevi un token di quotazione (exchangeRateToken) con una data di scadenza. Le operazioni inviate con quel token prima della scadenza usano il tasso bloccato.

Con un Wire In: un bonifico che notifichi tramite l’API o il Business Portal, oppure USDC o USDT su Ethereum o Tron, rilevati e accreditati automaticamente, di solito 2–10 minuti dopo la conferma on-chain.

Con un Wire Out verso il tuo conto bancario esterno o verso un wallet USDC o USDT autorizzato. I Wire Out non vanno mai a terzi; i pagamenti a terzi passano dai payout.

No. Le stablecoin sono uno strumento di tesoreria: USDC e USDT finanziano il tuo conto aziendale e possono essere prelevate verso wallet autorizzati. Non offriamo on-ramp od off-ramp cripto per i consumatori.

Richiedi una quotazione tramite API o Business Portal e ricevi il tasso di quel momento, incluso il margine stabilito nel tuo contratto, con un token di quotazione che lo blocca fino alla scadenza. Il tasso applicato è registrato su ogni conversione.

Sì. Il tuo conto mantiene un saldo separato per valuta – le valute locali in cui incassi, più le valute forti e le stablecoin verso cui converti o con cui alimenti – e il Business Portal mostra l’attività per valuta.

Un incasso è un pagamento del tuo cliente. Un Wire In è denaro tuo: un bonifico o un deposito in USDC o USDT che alimenta il tuo saldo Localpayment, di solito prima di inviare payout.

Un Wire Out in valuta fiat segue i tempi di elaborazione della banca ricevente e del circuito usato; i prelievi in stablecoin si confermano on-chain. Puoi seguire ogni Wire Out nel Business Portal e via webhook.

Le conversioni vanno da valuta locale a valuta forte. Per pagare localmente, alimenti il conto in valuta forte o stablecoin e i payout vengono eseguiti in valuta locale dal tuo saldo secondo il tuo contratto.

Sì. I rimborsi sono disponibili per pagamenti con carta, conti virtuali e metodi di pagamento alternativi. Per i chargeback su carta puoi caricare le prove di ogni contestazione tramite l’API o il Business Portal.

Dipende dal metodo. I rimborsi su carta compaiono sull’estratto quando l’emittente li contabilizza; i rimborsi di bonifici, QR e conti virtuali vengono inviati al conto del pagatore tramite il circuito locale. Ogni rimborso ha il proprio stato e webhook.

Le regole di rimborso dipendono dal metodo di pagamento. La sezione rimborsi della documentazione indica, per ciascun metodo, se i rimborsi parziali sono consentiti ed entro quale finestra temporale.

Il titolare contesta un addebito presso il suo emittente, l’importo viene stornato e ricevi una notifica nel Business Portal e via webhook. Puoi caricare prove tramite API o portale entro la scadenza fissata dal circuito; l’emittente decide l’esito.

I pagamenti bancari non hanno il meccanismo di chargeback delle carte: una volta confermato il bonifico, i fondi sono tuoi. Se devi restituire denaro, emetti un rimborso.

Offri metodi bancari locali, attiva 3D Secure sulle carte, conserva le prove di consegna e rispondi alle dispute con evidenze nei tempi. La nostra piattaforma aggiunge controlli antifrode come velocity check e risk scoring.

Un rimborso è una restituzione di fondi avviata da te. Una restituzione è un payout rimandato indietro dalla banca del beneficiario, per esempio perché il conto era chiuso. Un chargeback è un pagamento con carta stornato dall’emittente su richiesta del titolare.

POST /api/token/ scambia username e password API con un access token valido 5 minuti e un refresh token valido 24 ore. Invia l’access token come Authorization: Bearer in ogni chiamata, solo da codice lato server, e autorizza gli IP dei tuoi server nel Business Portal.

Non esistono SDK server ufficiali: l’API REST funziona con qualsiasi client HTTP e la documentazione include una collection Postman. Per acquisire la carta nel browser, l’SDK JavaScript di Smart Fields offre campi carta ospitati.

Invia il tuo externalId univoco con ogni transazione. Riutilizzarlo restituisce HTTP 409 Conflict invece di creare una seconda transazione, quindi ritentare dopo un timeout è sicuro.

Configuri un endpoint HTTPS nel Business Portal. Ogni notifica è firmata con l’HMAC-SHA256 del body grezzo, inviato nell’header x-Signature. Rispondi subito con 200 ed elabora in modo asincrono; le consegne senza 200 vengono ritentate con backoff esponenziale.

Sì. Stage (api.stage.localpayment.com) replica la produzione senza denaro reale, con carte di test, un simulatore di pagamenti per i conti virtuali e scenari di test per i payout.

Sì. Un server MCP pubblico in sola lettura su docs.localpayment.com/mcp e un indice llms.txt permettono al tuo assistente di lavorare sul contratto reale dell’API. Rivedi il codice generato come qualsiasi altro codice prima di andare in produzione.

Un’API REST diretta, una pagina WebCheckout ospitata, link di pagamento, un iframe incorporato, l’SDK JavaScript Smart Fields per l’acquisizione delle carte, caricamenti in blocco nel Business Portal e un server MCP per gli strumenti di codice AI. La pagina delle integrazioni confronta impegno e perimetro PCI di ciascuna.

La console web per il tuo team: monitora le transazioni, carica payout in blocco, configura webhook e allow-list di IP, gestisci gli utenti con ruoli e permessi personalizzati e approva i payout con doppia firma.

Con codici di stato HTTP standard – 4xx per errori di richiesta e 5xx per errori del server – più un codice e un messaggio di errore, e dettagli per campo negli errori di validazione. Registra il codice di errore insieme al tuo externalId per velocizzare il supporto.

Sì. La documentazione include una collection Postman con ambienti Stage e Produzione, richieste di esempio per ogni endpoint e helper di autenticazione.

Sì. L’API limita il volume di richieste per proteggere il servizio. Quando ricevi una risposta di limite, applica un backoff esponenziale invece di riprovare subito, e affidati ai webhook anziché al polling per lo stato.

Completati i test in Stage, la revisione di sicurezza e il KYB, ricevi le credenziali di produzione. Cambia l’URL base in api.v3.localpayment.com, inserisci gli IP di produzione nella allow-list e configura l’endpoint webhook di produzione. Il contratto dell’API è lo stesso.

Calcola l’HMAC-SHA256 sul corpo grezzo della richiesta con il tuo segreto webhook e confrontalo, con un confronto a tempo costante, con il valore esadecimale dell’header x-Signature. Rifiuta la notifica se differiscono.

Sì. Piattaforme, marketplace e PSP operano più merchant o entità con una sola integrazione. Come si organizzano conti, saldi e regolamenti dipende dal tuo modello: parla con le vendite della configurazione.

L’assistenza clienti è disponibile 24/7 all’indirizzo support@localpayment.com. Le segnalazioni di sicurezza vanno a cybersecurity@localpayment.com e i clienti in Brasile possono contattare il nostro ombudsman (ouvidoria) all’indirizzo ouvidoria@localpayment.com.

status.localpayment.com mostra la disponibilità in tempo reale dei servizi di incasso, payout e autenticazione e dei circuiti di ogni paese, oltre allo storico degli incidenti.

Scrivi a support@localpayment.com. I clienti in Brasile possono contattare il nostro ombudsman a ouvidoria@localpayment.com e chiunque può usare il canale etico https://www.contatoseguro.com.br/en/localpayment. La policy sui reclami è pubblicata nella sezione legale.

Localpayment elabora pagamenti per le aziende, quindi l’addebito proviene da un esercente presso cui hai acquistato. Contatta prima quell’esercente. Se non riesci a identificarlo, scrivi a support@localpayment.com con data e importo e ti aiuteremo.

Sì. Un team tecnico accompagna la tua integrazione dal kickoff al go-live, con revisioni dell’integrazione e supporto ai test, e support@localpayment.com risponde 24 ore su 24.

Controlla status.localpayment.com per la disponibilità in tempo reale e lo storico degli incidenti, e scrivi a support@localpayment.com con i tuoi externalId e gli orari. Il supporto clienti risponde 24 ore su 24.

docs.localpayment.com contiene le guide di integrazione e il riferimento API. L’hub sviluppatori di questo sito collega quickstart, sandbox, webhook e strumenti di IA.