Sandbox
Jeden Ablauf auf Stage testen. Ohne echtes Geld.
Stage bildet die Produktion ab: derselbe API-Vertrag, dieselben Webhooks und ein eigenes Business Portal. Sie entwickeln und testen gegen den Vertrag, den Sie live betreiben werden. Nur das Geld ist simuliert.
- Bildet die Produktion ab
- Testkarten und Simulatoren
- Postman-Collection
Bildet die Produktion abÜbersicht
USD
1.284.560,00
+4,2 %
BRL
3.420.118,40
+12,8 %
MXN
8.905.332,10
+6,1 %
- Pay-in · Pixorder_8F2K-1043+ R$ 1.250,00
- Auszahlung · SPEIseller_0921− MX$ 18.400,00
- FX · BRL → USDfx_3b7q250.000,00 USD
- Pay-in · Bre-Border_9A1C-2210+ COP 890.000
Umgebungen
Zwei Umgebungen, eine Integration
Sie wechseln die Umgebung, indem Sie die Base-URL und die geladenen Zugangsdaten ändern.
API-Base-URL
- Stage (Sandbox)
- https://api.stage.localpayment.com
- Produktion
- https://api.v3.localpayment.com
Business Portal
- Stage (Sandbox)
- ui.stage.localpayment.com
- Produktion
- ui.v3.localpayment.com
Geld
- Stage (Sandbox)
- Simuliert: Es bewegen sich keine echten Mittel
- Produktion
- Echte Mittel über echte Zahlungsschienen
Zugangsdaten
- Stage (Sandbox)
- Ausgestellt zu Beginn der Partnerschaft
- Produktion
- Ausgestellt nach Stage-Tests, Sicherheits-Review und KYB
Daten
- Stage (Sandbox)
- Ausschließlich fiktive Testdaten
- Produktion
- Echte Kundendaten, geschützt durch Ihre und unsere Kontrollen
IP-Allowlisting
- Stage (Sandbox)
- Erforderlich
- Produktion
- Erforderlich
Stage- und Produktionszugangsdaten sind unterschiedlich. Speichern Sie sie als getrennte Secrets.
Was Sie testen können
Proben Sie, was Sie in der Produktion betreiben
Karteneinzahlungen
Genehmigungen, Ablehnungen, 3-D-Secure-Challenges und Verarbeitungsfehler, jeweils mit eigener Testkartennummer.
Virtuelle Konten
Legen Sie Konten an und simulieren Sie eingehende Überweisungen, um Zuordnung, Abstimmung und Webhooks durchzuspielen.
Lokale Zahlungsmethoden
Legen Sie Einzahlungen per Pix und anderen lokalen Methoden an und prüfen Sie QR-Codes, Zahlungsanweisungen und ausstehende Status.
Auszahlungen
Spielen Sie die dokumentierten Sandbox-Szenarien für Auszahlungen durch und sehen Sie jeden Status im Auszahlungsablauf.
Webhooks von Anfang bis Ende
Richten Sie eine Stage-Benachrichtigungs-URL auf Ihren Endpunkt und prüfen Sie Signaturen vor der Produktion.
Fehlerbehandlung
Senden Sie eine externalId erneut, um 409 Conflict zu sehen, lassen Sie einen Token ablaufen und üben Sie Wiederholungen mit Backoff.
Testkarten
Kartennummern für jedes Ergebnis
Verwenden Sie ein beliebiges Ablaufdatum in der Zukunft. CVC: beliebige 3 Ziffern (4 bei Amex).
4242 4242 4242 4242
- Ergebnis
- Genehmigt
- Damit testen Sie
- Den Idealfall: Autorisierung, Bestätigung und Webhook
4000 0000 0000 0002
- Ergebnis
- Abgelehnt
- Damit testen Sie
- Ablehnungsmeldungen und Wiederholungshinweise in Ihrem Checkout
4000 0025 0000 3155
- Ergebnis
- 3-D-Secure-Challenge
- Damit testen Sie
- Den Authentifizierungsschritt und die Rückkehr in Ihren Ablauf
4000 0000 0000 9995
- Ergebnis
- Verarbeitungsfehler
- Damit testen Sie
- Fehlerbehandlung, Logging und Kundenkommunikation
Nur für Stage. Kartenakzeptanz ist in Argentinien, Kolumbien, Mexiko und Peru verfügbar; 3D Secure gilt in Kolumbien, Mexiko und Peru.
Simulator für virtuelle Konten
Banküberweisung auf Abruf simulieren
Kein Warten auf eine echte Überweisung: Legen Sie auf Stage ein virtuelles Konto an, rufen Sie den Simulator auf und verfolgen Sie die simulierte Zahlung durch Zuordnung, Statusaktualisierungen und Ihre Benachrichtigungsverarbeitung.
- POST /api/simulate/va ist nur auf Stage verfügbar
- Nutzen Sie ihn, um Ihre VirtualAccount-Webhook-Verarbeitung vor dem Go-live durchzuspielen
- Ideal für automatisierte End-to-End-Tests in Ihrer CI-Pipeline
# Nur auf Stage. Beispielhafte Bodies: den genauen Vertrag finden Sie im Test-Leitfaden.
# 1) Virtuelles Konto für einen Testkunden anlegen (Mexiko, 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) Eingehende Banküberweisung auf dieses Konto simulieren
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) Ihr Webhook-Endpunkt erhält eine VirtualAccount-BenachrichtigungPostman
Collection importieren, ersten Request senden
Die Postman-Collection von Localpayment enthält eine Stage-Umgebungsdatei, sodass Sie die API erkunden können, bevor Sie eine Zeile Code schreiben.
- Eine STAGE-Umgebungsdatei, die jeden Request auf die Sandbox richtet
- Nutzen Sie sie zusammen mit der API-Referenz, um Request- und Response-Strukturen zu prüfen
- Hinterlegen Sie Ihre Stage-Zugangsdaten lokal und teilen Sie niemals einen Workspace, der sie enthält
Bewährte Praxis
Testen Sie wie in der Produktion
Nur fiktive Daten
Verwenden Sie erfundene Namen und Dokumentnummern. Laden Sie niemals echte Kunden- oder Kartendaten in Stage.
Getrennte Secrets
Halten Sie Stage- und Produktionszugangsdaten getrennt, jeweils in Ihrem Secrets Manager.
Auch die Fehlerpfade testen
Ablehnungen, 3D Secure, Timeouts, 409-Duplikate und abgelaufene Tokens – nicht nur Genehmigungen.
Webhook-Wiederholungen durchspielen
Antworten Sie einmal mit einem Nicht-200-Status und bestätigen Sie, dass Ihr Handler die erneute Zustellung genau einmal anwendet.
Token-Laufzeiten beachten
Access-Tokens gelten 5 Minuten. Bauen Sie die Refresh-Logik jetzt, nicht erst nach dem Go-live.
Testsuite automatisieren
Führen Sie End-to-End-Tests gegen Stage in Ihrer CI aus, mit dem Simulator für virtuelle Konten.
Zugang erhalten
So erhalten Sie Stage-Zugangsdaten
- 01
Stellen Sie uns Ihr Projekt vor
Teilen Sie uns Anwendungsfall, Märkte und erwartete Volumina über das Kontaktformular mit.
- 02
Partnerschaft starten
Die kommerziellen Bedingungen werden vereinbart und das Onboarding beginnt, einschließlich einer Compliance-Prüfung.
- 03
Stage-Zugangsdaten erhalten
Sie bekommen einen API-Benutzer und ein Passwort für Stage sowie Zugang zum Stage-Business-Portal.
- 04
Freigeben und entwickeln
Hinterlegen Sie Ihre Server-IPs, importieren Sie die Postman-Collection und folgen Sie dem Quickstart.
FAQ zur Sandbox
Bewegt Stage echtes Geld?
Nein. Stage bildet das Produktionsverhalten mit simulierten Mitteln ab. Nichts, was Sie dort tun, erreicht eine echte Bank, ein Kartennetzwerk oder eine Wallet.
Darf ich auf Stage echte Kundendaten verwenden?
Nein. Verwenden Sie ausschließlich fiktive Namen, Dokumentnummern und Karten. Echte personenbezogene Daten oder Kartendaten dürfen niemals an eine Testumgebung gesendet werden.
Worin unterscheidet sich Stage von der Produktion?
API-Vertrag und Webhooks sind identisch. Zahlungen werden simuliert (Überweisungen auf virtuelle Konten kommen beispielsweise vom Simulator), daher spiegeln die Laufzeiten keine echten Zahlungsschienen wider.
Wie wechsle ich in die Produktion?
Schließen Sie die Stage-Tests, das Sicherheits-Review und die Unternehmensverifizierung (KYB) ab. Danach stellen wir Produktionszugangsdaten aus. Der Quickstart enthält die vollständige Go-live-Checkliste.
An wen wende ich mich, wenn etwas nicht funktioniert?
Schreiben Sie an support@localpayment.com, rund um die Uhr erreichbar, oder nutzen Sie „Ask AI“ in der Doku für schnelle Antworten.
Holen Sie sich Ihre Stage-Zugangsdaten
Starten Sie das Gespräch mit unserem Team. Der Stage-Zugang wird zu Beginn Ihrer Partnerschaft freigeschaltet.