Smart routing e cascata
Il percorso giusto per ogni transazione.
Localpayment invia ogni transazione sulla connessione locale più adatta a completarla e, quando una connessione fallisce, passa in cascata a un’alternativa, così il problema di un singolo fornitore non diventa il tuo disservizio.
- Un’integrazione, tante connessioni
- Fallback automatico
- Regole configurate con il nostro team
Un’integrazione, tante connessioniCosa fa
Routing che lavora dietro la tua integrazione
Routing e cascata funzionano dietro la stessa API che già usi. Non devi integrare ogni connessione locale: lo facciamo noi.
Instrada
Ogni transazione viene valutata rispetto alle connessioni locali disponibili per il suo paese e metodo di pagamento.
Cascata
Se una connessione fallisce per motivi tecnici o peggiora, la transazione può essere ritentata su un’alternativa.
Resilienza
L’incidente di un singolo fornitore non deve per forza fermare i tuoi pagamenti.
Un’unica integrazione
Le connessioni vengono aggiunte e mantenute da noi, senza nuove integrazioni da parte tua.
Regole definite con te
Copertura e regole di routing vengono concordate con il nostro team per i tuoi paesi, metodi e flussi.
Stato trasparente
Lo stato dei componenti e lo storico degli incidenti sono pubblici sulla nostra pagina di stato.
Come funziona
Valuta, instrada, passa in cascata, riporta
Valuta
Ogni transazione viene confrontata con le connessioni disponibili per il suo paese, il metodo e le regole.
Instrada
Viene inviata alla connessione più adatta a completarla.
Cascata
Se quella connessione fallisce o peggiora, la transazione passa a un’alternativa, se configurata.
Riporta
Mantieni un solo record e un solo stato per transazione, qualunque percorso abbia seguito.
Ambito
Cosa copre il routing e cosa richiede da te
Metodi di incasso
- Cosa include
- Bonifici, QR, wallet e carte secondo disponibilità per paese
- Note
- Confermato per mercato durante l’onboarding
Paesi
- Cosa include
- Uno qualsiasi dei 14 paesi con circuiti locali
- Note
- Fallback solo dove un mercato ha più di una connessione
Trigger
- Cosa include
- Errori tecnici e connessioni degradate
- Note
- I rifiuti di business (fondi insufficienti, dati errati) non vengono ritentati
Regole
- Cosa include
- Configurate con il nostro team per paese, metodo e flusso
- Note
- Riviste al variare di volumi e mercati
Limiti e prezzi
- Cosa include
- Nessun limite proprio; valgono quelli del metodo di pagamento
- Note
- Parla con il team commerciale
La tua integrazione
- Cosa include
- Stessi endpoint, stati, webhook e report
- Note
- Nulla da cambiare dal tuo lato
La copertura dipende dalle connessioni disponibili in ogni mercato. Il nostro team la conferma per i tuoi paesi e metodi.
Perché conta
Una sola connessione o pagamenti instradati in cascata
Una sola connessione
- Un unico punto di guastoQuando il fornitore ha un incidente, i tuoi pagamenti si fermano con lui.
- Gli errori tecnici sono definitiviUn timeout o una connessione degradata significano un pagamento perso.
- Ogni nuovo fornitore è un progettoAggiungere ridondanza vuol dire un’altra integrazione, un altro contratto e un altro report.
- Dati frammentatiOgni fornitore produce report nel proprio formato.
Routing e cascata Localpayment
- Connessioni di riservaDove un mercato ha più di una connessione, un’alternativa è pronta.
- Gli errori tecnici trovano un altro percorsoLe transazioni possono passare in cascata a un’altra connessione invece di fallire.
- Aggiunte tramite configurazioneLe nuove connessioni vengono configurate da noi, senza nuova integrazione.
- Un’API, un reportGli stessi stati, webhook e report su ogni percorso.
Copertura
Configurato per i tuoi mercati, con il nostro team
Routing e cascata dipendono dalle connessioni disponibili in ogni paese e per ogni metodo di pagamento. Durante l’onboarding, il nostro team definisce i percorsi e le regole di fallback adatti ai tuoi flussi, e li rivede quando cambiano i tuoi mercati e volumi.
- Definito per paese e metodo di pagamento
- Regole di fallback concordate con il tuo team
- Rivisto quando aggiungi mercati e volumi
Panoramica
USD
1.284.560,00
+4,2%
BRL
3.420.118,40
+12,8%
MXN
8.905.332,10
+6,1%
- Incasso · Pixorder_8F2K-1043+ R$ 1.250,00
- Payout · SPEIseller_0921− MX$ 18.400,00
- Cambio · BRL → USDfx_3b7q250.000,00 USD
- Incasso · Bre-Border_9A1C-2210+ COP 890.000
Trasparenza
Controlla lo stato di salute di ogni circuito
La nostra pagina di stato pubblica mostra in tempo reale lo stato dei componenti e lo storico degli incidenti: dalle API di incasso e payout ai servizi di autenticazione e ai circuiti di ogni paese.
- Stato dei componenti in tempo reale
- Storico e aggiornamenti degli incidenti
- Componenti dei circuiti per paese
- 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 i tuoi team
Pensato per i team responsabili delle performance dei pagamenti
Prodotto e crescita
La cascata offre un altro percorso ai pagamenti falliti per motivi tecnici, senza modifiche al tuo checkout.
Finance
Un unico flusso di regolamento e un unico report, qualunque connessione abbia elaborato il pagamento.
Engineering
Nessuna integrazione aggiuntiva per connessione: gli stessi endpoint, stati e webhook.
Casi d’uso
Dove routing e cascading fanno la differenza
E-commerce e marketplace
Il checkout continua a convertire durante un incidente del provider; l’acquirente non vede mai il fallback.
E-commerce e marketplace —Beni digitali, streaming e gaming
Pagamenti frequenti e di basso importo, dove ogni errore tecnico è una vendita persa.
Beni digitali, streaming e gaming —Piattaforme di pagamento
Offri ridondanza ai tuoi merchant senza integrare ogni connessione locale.
Piattaforme di pagamento —Fintech e wallet
Ricariche e trasferimenti continuano a fluire quando una connessione si degrada.
Fintech e wallet —
Per sviluppatori
Nessun campo di routing: la richiesta resta la stessa
Il routing avviene dietro l’endpoint Create Payin. Invii la stessa richiesta di sempre; la rotta e l’eventuale cascata vengono gestite dal nostro lato, e ricevi uno stato e un webhook per transazione.
- Stessa struttura di richiesta in ogni paese
- Un externalId, uno stato, un webhook, qualunque sia la rotta
- Stage replica la produzione senza denaro reale
# Crea un incasso PSE in Colombia (valori fittizi): il routing non richiede campi aggiuntivi
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": "9d2b4c10-0000-4000-8000-000000000042",
"country": "COL",
"currency": "COP",
"amount": 185000,
"accountNumber": "<your-account-number>",
"conceptCode": "0003",
"merchant": { "type": "COMPANY", "name": "Tienda Ejemplo S.A.S." },
"payer": {
"type": "INDIVIDUAL",
"name": "Camila",
"lastname": "Rojas",
"email": "camila@example.com",
"document": { "type": "CC", "id": "00000000" }
}
}'Domande frequenti
Serve un’integrazione separata per il routing?
No. Routing e cascata avvengono dietro la stessa API Localpayment che usi per i pagamenti.
Quali paesi e metodi di pagamento copre?
Dipende dalle connessioni disponibili in ogni mercato. Il nostro team conferma la copertura per i tuoi paesi e metodi durante l’onboarding.
Posso definire le mie regole di routing?
Le regole di routing e fallback vengono configurate insieme al nostro team, in base ai tuoi paesi, metodi di pagamento e flussi.
Pubblicate dati sull’aumento del tasso di approvazione?
No. I risultati dipendono dal tuo mix di paesi, metodi e clienti, quindi analizziamo le performance con te invece di citare un numero generico.
Il routing cambia i miei report o webhook?
No. Mantieni gli stessi stati, webhook e report, qualunque percorso segua una transazione.
Come vengo a sapere degli incidenti?
La pagina di stato pubblica mostra in tempo reale lo stato dei componenti e lo storico degli incidenti. Il nostro team di assistenza è disponibile 24/7 su support@localpayment.com.
Anche sulla stessa API
Fai contare ogni pagamento
Raccontaci i tuoi mercati e metodi: ti mostreremo come configurare routing e cascata per i tuoi flussi.