Sandbox
Testa ogni flusso su Stage. Senza denaro reale.
Stage rispecchia la produzione: stesso contratto API, stessi webhook e un proprio Business Portal. Sviluppi e testi sul contratto che userai in produzione. Solo il denaro è simulato.
- Rispecchia la produzione
- Carte di test e simulatori
- Collection Postman
Rispecchia la produzionePanoramica
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
Ambienti
Due ambienti, un’unica integrazione
Cambi ambiente modificando il base URL e le credenziali che carichi.
Base URL dell’API
- Stage (sandbox)
- https://api.stage.localpayment.com
- Produzione
- https://api.v3.localpayment.com
Business Portal
- Stage (sandbox)
- ui.stage.localpayment.com
- Produzione
- ui.v3.localpayment.com
Denaro
- Stage (sandbox)
- Simulato: non si muovono fondi reali
- Produzione
- Fondi reali su circuiti reali
Credenziali
- Stage (sandbox)
- Rilasciate all’avvio della partnership
- Produzione
- Rilasciate dopo i test su Stage, la security review e il KYB
Dati
- Stage (sandbox)
- Solo dati di test fittizi
- Produzione
- Dati reali dei clienti, protetti dai tuoi controlli e dai nostri
IP allow-listing
- Stage (sandbox)
- Obbligatorio
- Produzione
- Obbligatorio
Le credenziali di Stage e di Produzione sono diverse. Conservale come segreti separati.
Cosa puoi testare
Prova ciò che userai in produzione
Incassi con carta
Approvazioni, rifiuti, challenge 3D Secure ed errori di elaborazione, ognuno con il proprio numero di carta di test.
Conti virtuali
Crea conti e simula bonifici in entrata per mettere alla prova abbinamento, riconciliazione e webhook.
Metodi di pagamento locali
Crea incassi con Pix e altri metodi locali e controlla codici QR, istruzioni di pagamento e stati in attesa.
Payout
Esegui gli scenari sandbox documentati per i payout e osserva ogni stato lungo il flusso.
Webhook end-to-end
Punta un URL di notifica di Stage al tuo endpoint e verifica le firme prima della produzione.
Gestione degli errori
Ripeti un externalId per vedere 409 Conflict, lascia scadere un token ed esercitati con i retry con backoff.
Carte di test
Numeri di carta per ogni esito
Usa qualsiasi data di scadenza futura. CVC: 3 cifre qualsiasi (4 per Amex).
4242 4242 4242 4242
- Esito
- Approvata
- Usala per testare
- Il percorso ideale: autorizzazione, conferma e webhook
4000 0000 0000 0002
- Esito
- Rifiutata
- Usala per testare
- I messaggi di rifiuto e gli inviti a riprovare nel tuo checkout
4000 0025 0000 3155
- Esito
- Challenge 3D Secure
- Usala per testare
- Il passaggio di autenticazione e il ritorno nel tuo flusso
4000 0000 0000 9995
- Esito
- Errore di elaborazione
- Usala per testare
- La gestione degli errori, il logging e i messaggi ai clienti
Solo per Stage. L’accettazione delle carte è disponibile in Argentina, Colombia, Messico e Perù; il 3D Secure si applica in Colombia, Messico e Perù.
Simulatore di conti virtuali
Simula un bonifico quando vuoi
Non serve aspettare un bonifico reale: crea un conto virtuale su Stage, chiama il simulatore e segui il pagamento simulato attraverso abbinamento, aggiornamenti di stato e la gestione delle tue notifiche.
- POST /api/simulate/va è disponibile solo su Stage
- Usalo per mettere alla prova la gestione dei webhook VirtualAccount prima del go-live
- Ideale per test end-to-end automatizzati nella tua pipeline CI
# Solo su Stage. Body di esempio: consulta la guida ai test per il contratto esatto.
# 1) Crea un conto virtuale per un cliente di test (Messico, CLABE)
curl -X POST https://api.stage.localpayment.com/api/virtual-account \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"externalId": "3b9f6c1e-0000-4000-8000-000000000123",
"country": "MEX",
"currency": "MXN",
"beneficiary": { "name": "Ana Torres", "document": { "type": "RFC", "id": "TOAA800101XXX" } }
}'
# 2) Simula un bonifico in entrata su quel conto
curl -X POST https://api.stage.localpayment.com/api/simulate/va \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"accountNumber": "646180000000004821",
"amount": 1250.00,
"currency": "MXN"
}'
# 3) Il tuo endpoint webhook riceve una notifica VirtualAccountPostman
Importa la collection, invia la prima richiesta
La collection Postman di Localpayment include un file di ambiente Stage, così puoi esplorare l’API prima di scrivere una sola riga di codice.
- Un file di ambiente STAGE che punta ogni richiesta alla sandbox
- Usalo insieme alla reference dell’API per esaminare la struttura di richieste e risposte
- Aggiungi le tue credenziali Stage in locale e non condividere mai un workspace che le contiene
Buone pratiche
Testa come se fossi in produzione
Solo dati fittizi
Usa nomi e numeri di documento inventati. Non caricare mai dati reali di clienti o carte su Stage.
Segreti separati
Tieni separate le credenziali di Stage e di Produzione, ognuna nel tuo secrets manager.
Testa i casi negativi
Rifiuti, 3D Secure, timeout, duplicati 409 e token scaduti, non solo le approvazioni.
Metti alla prova i retry dei webhook
Restituisci una volta uno stato diverso da 200 e verifica che il tuo handler applichi il nuovo invio esattamente una volta.
Rispetta la durata dei token
I token di accesso durano 5 minuti. Scrivi subito la logica di refresh, non dopo il go-live.
Automatizza la tua suite
Esegui test end-to-end su Stage nella tua CI, usando il simulatore di conti virtuali.
Ottenere l’accesso
Come ottenere le credenziali Stage
- 01
Raccontaci il tuo progetto
Condividi caso d’uso, mercati e volumi previsti tramite il modulo di contatto.
- 02
Avvia la partnership
Si concordano le condizioni commerciali e inizia l’onboarding, compresa una verifica di compliance.
- 03
Ricevi le credenziali Stage
Ottieni un utente e una password API per Stage, più l’accesso al Business Portal di Stage.
- 04
Autorizza gli IP e sviluppa
Aggiungi gli IP dei tuoi server, importa la collection Postman e segui il quickstart.
FAQ sulla sandbox
Stage muove denaro reale?
No. Stage riproduce il comportamento della produzione con fondi simulati. Nulla di ciò che fai lì raggiunge una banca, un circuito di carte o un wallet reali.
Posso usare dati reali dei clienti su Stage?
No. Usa solo nomi, numeri di documento e carte fittizi. Dati personali o di carte reali non devono mai essere inviati a un ambiente di test.
In cosa Stage è diverso dalla produzione?
Il contratto API e i webhook sono gli stessi. I pagamenti sono simulati (i bonifici sui conti virtuali, per esempio, arrivano dal simulatore), quindi i tempi non riflettono quelli dei circuiti reali.
Come passo alla produzione?
Completa i test su Stage, la security review e la verifica aziendale (KYB). Poi rilasciamo le credenziali di produzione. Il quickstart include la checklist completa per il go-live.
Chi contatto se qualcosa non funziona?
Scrivi a support@localpayment.com, attivo 24/7, oppure usa “Ask AI” nella documentazione per risposte rapide.
Ottieni le tue credenziali Stage
Inizia a parlare con il nostro team. L’accesso a Stage viene attivato all’avvio della tua partnership.