Sandbox
Testez chaque flux sur Stage. Sans argent réel.
Stage reproduit la production : le même contrat d’API, les mêmes webhooks et son propre Business Portal. Vous développez et testez sur le contrat que vous exploiterez en production. Seul l’argent est simulé.
- Reproduit la production
- Cartes de test et simulateurs
- Collection Postman
Reproduit la productionAperçu
USD
1 284 560,00
+4,2 %
BRL
3 420 118,40
+12,8 %
MXN
8 905 332,10
+6,1 %
- Encaissement · Pixorder_8F2K-1043+ R$ 1 250,00
- Décaissement · SPEIseller_0921− MX$ 18 400,00
- Change · BRL → USDfx_3b7q250 000,00 USD
- Encaissement · Bre-Border_9A1C-2210+ COP 890 000
Environnements
Deux environnements, une seule intégration
Changez d’environnement en modifiant l’URL de base et les identifiants que vous chargez.
URL de base de l’API
- Stage (sandbox)
- https://api.stage.localpayment.com
- Production
- https://api.v3.localpayment.com
Business Portal
- Stage (sandbox)
- ui.stage.localpayment.com
- Production
- ui.v3.localpayment.com
Argent
- Stage (sandbox)
- Simulé : aucun fonds réel ne circule
- Production
- Fonds réels sur de vrais rails
Identifiants
- Stage (sandbox)
- Délivrés au démarrage du partenariat
- Production
- Délivrés après les tests sur Stage, la revue de sécurité et le KYB
Données
- Stage (sandbox)
- Données de test fictives uniquement
- Production
- Données clients réelles, protégées par vos contrôles et les nôtres
Liste blanche d’IP
- Stage (sandbox)
- Obligatoire
- Production
- Obligatoire
Les identifiants Stage et Production sont différents. Stockez-les comme des secrets distincts.
Ce que vous pouvez tester
Répétez ce que vous exploiterez en production
Encaissements par carte
Autorisations, refus, challenges 3D Secure et erreurs de traitement, chacun avec son propre numéro de carte de test.
Comptes virtuels
Créez des comptes et simulez des virements entrants pour éprouver l’appariement, le rapprochement et les webhooks.
Moyens de paiement locaux
Créez des encaissements Pix et par d’autres moyens locaux, et inspectez QR codes, instructions de paiement et statuts en attente.
Décaissements
Jouez les scénarios sandbox documentés pour les décaissements et observez chaque statut du flux.
Webhooks de bout en bout
Pointez une URL de notification Stage vers votre endpoint et vérifiez les signatures avant la production.
Gestion des échecs
Rejouez un externalId pour obtenir 409 Conflict, laissez expirer un jeton et entraînez-vous aux relances avec backoff.
Cartes de test
Des numéros de carte pour chaque résultat
Utilisez n’importe quelle date d’expiration future. CVC : 3 chiffres au choix (4 pour Amex).
4242 4242 4242 4242
- Résultat
- Approuvée
- À utiliser pour tester
- Le parcours nominal : autorisation, confirmation et webhook
4000 0000 0000 0002
- Résultat
- Refusée
- À utiliser pour tester
- Les messages de refus et les invitations à réessayer dans votre checkout
4000 0025 0000 3155
- Résultat
- Challenge 3D Secure
- À utiliser pour tester
- L’étape d’authentification et le retour dans votre parcours
4000 0000 0000 9995
- Résultat
- Erreur de traitement
- À utiliser pour tester
- La gestion des erreurs, la journalisation et les messages clients
Pour Stage uniquement. L’acceptation des cartes est disponible en Argentine, en Colombie, au Mexique et au Pérou ; le 3D Secure s’applique en Colombie, au Mexique et au Pérou.
Simulateur de comptes virtuels
Simulez un virement bancaire à la demande
Inutile d’attendre un vrai virement : créez un compte virtuel sur Stage, appelez le simulateur et suivez le paiement simulé à travers l’appariement, les mises à jour de statut et le traitement de vos notifications.
- POST /api/simulate/va est disponible uniquement sur Stage
- Utilisez-le pour éprouver le traitement de vos webhooks VirtualAccount avant la mise en production
- Idéal pour des tests de bout en bout automatisés dans votre pipeline CI
# Stage uniquement. Corps illustratifs : consultez le guide de test pour le contrat exact.
# 1) Créez un compte virtuel pour un client de test (Mexique, 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) Simulez un virement entrant sur ce compte
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) Votre endpoint de webhooks reçoit une notification VirtualAccountPostman
Importez la collection, envoyez votre première requête
La collection Postman de Localpayment est livrée avec un fichier d’environnement Stage : vous pouvez explorer l’API avant d’écrire la moindre ligne de code.
- Un fichier d’environnement STAGE qui dirige chaque requête vers la sandbox
- À utiliser avec la référence de l’API pour examiner la structure des requêtes et des réponses
- Ajoutez vos identifiants Stage en local et ne partagez jamais un workspace qui les contient
Bonnes pratiques
Testez comme en production
Données fictives uniquement
Utilisez des noms et numéros de document inventés. Ne chargez jamais de vraies données clients ou de carte dans Stage.
Secrets séparés
Gardez les identifiants Stage et Production séparés, chacun dans votre gestionnaire de secrets.
Testez les cas d’échec
Refus, 3D Secure, timeouts, doublons 409 et jetons expirés, pas seulement les autorisations.
Éprouvez les relances de webhook
Renvoyez une fois un statut autre que 200 et vérifiez que votre handler n’applique la livraison relancée qu’une seule fois.
Respectez la durée de vie des jetons
Les jetons d’accès durent 5 minutes. Développez la logique de rafraîchissement dès maintenant, pas après la mise en production.
Automatisez votre suite
Exécutez des tests de bout en bout sur Stage dans votre CI, avec le simulateur de comptes virtuels.
Obtenir l’accès
Comment obtenir des identifiants Stage
- 01
Présentez-nous votre projet
Partagez votre cas d’usage, vos marchés et vos volumes prévus via le formulaire de contact.
- 02
Lancez le partenariat
Les conditions commerciales sont convenues et l’onboarding démarre, avec une revue de conformité.
- 03
Recevez vos identifiants Stage
Vous obtenez un utilisateur et un mot de passe API pour Stage, ainsi que l’accès au Business Portal de Stage.
- 04
Autorisez vos IP et développez
Ajoutez les IP de vos serveurs, importez la collection Postman et suivez le quickstart.
FAQ sandbox
Stage fait-il circuler de l’argent réel ?
Non. Stage reproduit le comportement de la production avec des fonds simulés. Rien de ce que vous y faites n’atteint une vraie banque, un réseau de cartes ou un wallet.
Puis-je utiliser de vraies données clients sur Stage ?
Non. Utilisez uniquement des noms, numéros de document et cartes fictifs. Aucune donnée personnelle ou de carte réelle ne doit être envoyée à un environnement de test.
En quoi Stage diffère-t-il de la production ?
Le contrat d’API et les webhooks sont identiques. Les paiements sont simulés (les virements sur comptes virtuels, par exemple, proviennent du simulateur) : les délais ne reflètent donc pas ceux des rails réels.
Comment passer en production ?
Terminez les tests sur Stage, la revue de sécurité et la vérification de l’entreprise (KYB). Nous délivrons ensuite les identifiants de production. Le quickstart contient la checklist complète de mise en production.
Qui contacter si quelque chose ne fonctionne pas ?
Écrivez à support@localpayment.com, disponible 24/7, ou utilisez « Ask AI » dans la documentation pour des réponses rapides.
Obtenez vos identifiants Stage
Entamez la conversation avec notre équipe. L’accès à Stage est ouvert au démarrage de votre partenariat.