Pay-ins
Lassen Sie Kunden zahlen, wie es ihr Markt gewohnt ist.
Bieten Sie im Checkout die unterstützten lokalen Zahlungsarten an, erhalten Sie Bestätigungen über Transaktions-Updates und verbinden Sie eingehende Gelder mit dem Rest Ihres Geschäftsbetriebs.
- Ein Endpunkt: POST /api/payin/
- Landeswährung, ein Guthaben
- Signierte Webhooks für jeden Status
Ein Endpunkt: POST /api/payin/
- Länder mit Pay-ins
- 9
- Länder mit virtuellen Konten
- 7
- Länder mit Karten: Argentinien, Kolumbien, Mexiko und Peru
- 4
- Echtzeitstatus für jede Zahlung
- Webhooks
Die Herausforderung
Grenzüberschreitendes Inkasso verschenkt Umsatz
Internationale Karten sind nur ein Teil des Bildes. In der ganzen Region wird per Überweisung und QR-Code bezahlt – und jedes Land macht es anders.
Inkasso ohne lokalen Partner
- Nur KartenViele Käufer bevorzugen Überweisung oder QR und brechen ohne diese Optionen ab.
- Eine neue Integration pro LandJeder Markt hat eigene Zahlungssysteme, Dokumente, Limits und Regeln.
- Manueller AbgleichZahlungen mehrerer Anbieter von Hand abzugleichen ist langsam und fehleranfällig.
Inkasso mit Localpayment
- Die Methoden, die Menschen bereits nutzenPix, PSE, Bre-B, CVU, CLABE, QR und lokale Kartensysteme über eine Integration.
- Ein Schema für alle LänderÜberall dieselben Felder: country, currency, amount, paymentMethod, externalId.
- Ein Guthaben, ein Report, ein Webhook-FormatJeder Zahlungseingang wird Ihrem Konto gutgeschrieben und in denselben Reports abgeglichen.
Zahlungsmethoden
Unterstützte lokale Methoden, ein Endpunkt.
Wählen Sie die Methoden, die jeder Markt bevorzugt. Die Request-Struktur bleibt gleich – nur Zahlungsmethodencode, Land und Währung ändern sich.
Karten
- ar
- co
- mx
- pe
Visa und Mastercard in Argentinien, Kolumbien, Mexiko und Peru, dazu American Express, Naranja und Cabal in Argentinien sowie American Express und Diners Club in Kolumbien.
Karten —Virtuelle Konten
- ar
- br
- cl
- co
- cr
- mx
- pe
Eine eigene CVU, CLABE, CCI, IBAN, ein Pix- oder Bre-B-Schlüssel oder eine chilenische Kontonummer pro Kunde, Rechnung oder Bestellung.
Virtuelle Konten —Lokale Zahlungsmethoden (APMs)
- ar
- bo
- br
- cl
- co
- gt
- pe
Pix in Brasilien, PSE in Kolumbien, Debin und QR in Argentinien, ETPAY in Chile, QR in Bolivien und Peru sowie QR Fri und Wallet Fri in Guatemala.
Lokale Zahlungsmethoden (APMs) —Abonnements
- co
- mx
- pe
Geplante Abos oder Belastungen nach Bedarf mit konfigurierbaren Wiederholungsversuchen.
Abonnements —
ar
co
mx
pe
br
cl
cr
bo
gtGeldfluss
Vom Checkout auf Ihr Guthaben
Eine Anfrage erstellt die Zahlung, die lokale Schiene bestätigt sie, ein signierter Webhook informiert Ihre Plattform.
- 1
KundeIhre Plattform:
Wählt eine lokale Methode
Pix, SPEI, PSE, Bre-B, Karten oder jede im Land verfügbare Methode.
- 2
Ihre PlattformLocalpayment:
POST /api/payin/
Betrag, Währung, Land und Zahlerdaten in einer Anfrage.
- 3
LocalpaymentKunde:
Zahlungsanweisungen
QR-Code, Schlüssel, Referenz oder Weiterleitung, je nach Methode.
- 4
KundeLokale Schiene / Bank:
Zahlt in der Bank-App
Der Zahler autorisiert bei seiner eigenen Bank oder Wallet.
- 5
Lokale Schiene / BankLocalpayment:
Schiene bestätigt
Echtzeitschienen bestätigen in Sekunden, andere folgen ihren eigenen Cut-offs.
- 6
LocalpaymentIhre Plattform:
Signierter Webhook
Ihr System gibt die Bestellung frei und das Guthaben wird gutgeschrieben.
Beispielhafter Ablauf. Bestätigungszeit und Cut-offs hängen von Methode und Land ab.
So funktioniert es
Vom Request zum Guthaben in vier Schritten
- 01
Request
POST /api/payin/ mit Land (ISO-3), Währung, Betrag, paymentMethod und Ihrer eindeutigen externalId.
- 02
Kunde zahlt
Karten werden in Echtzeit autorisiert. Virtuelle Konten und lokale Zahlungsmethoden bestätigen asynchron.
- 03
Webhook
Ein HMAC-SHA256-signierter Webhook liefert das Ergebnis, Ihre externalId und unsere internalId.
- 04
Guthaben gutgeschrieben
Der Zahlungseingang wird Ihrem Localpayment-Konto in Ihrer Abrechnungswährung gutgeschrieben, meist in USD.
Lebenszyklus
Den gesamten Zahlungslebenszyklus steuern
Alles, was nach der Zahlung passiert, läuft auf derselben Plattform – über die API oder das Business Portal.
- Erstattungen für Karten-, virtuelle-Konten- und APM-Zahlungen
- Chargeback-Management mit Upload von Nachweisen über die API
- Stornierung ausstehender APM-Zahlungen vor der Freigabe durch den Zahler
- Download von Zahlungsnachweisen für Erstattungen
- Dynamische Checkouts mit dem Endpunkt Get Available Payment Methods
- FX bei der Zahlung, mit per Quote-Token fixiertem Kurs
- 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" } } }Für Entwickler
Ein Endpunkt, länderspezifische Felder.
Authentifizieren Sie sich mit POST /api/token/ und rufen Sie dann für jedes Land denselben Create-Payin-Endpunkt auf – mit den Feldern, die das jeweilige Land verlangt. Dieses Pix-Beispiel liefert einen QR-Code und bestätigt per Webhook.
- Bearer-Tokens: Access-Token 5 Minuten, Refresh-Token 24 Stunden gültig
- Ihre externalId in jedem Request; Duplikate liefern HTTP 409
- Stage spiegelt die Produktion – ohne echtes Geld
# 1) Access-Token abrufen (Stage). Zugangsdaten in einem Secrets Manager aufbewahren.
curl -X POST https://api.stage.localpayment.com/api/token/ \
-H "Content-Type: application/json" \
-d '{ "username": "<api-user>", "password": "<from-your-secrets-manager>" }'
# 2) Pix-Pay-in anlegen (fiktive Werte)
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": "1314", "flow": "DIRECT" },
"externalId": "7c1e2f7a-0000-4000-8000-000000000001",
"country": "BRA",
"currency": "USD",
"amount": 100,
"accountNumber": "<your-account-number>",
"conceptCode": "0003",
"merchant": { "type": "COMPANY", "name": "Loja Exemplo Ltda" },
"payer": {
"type": "INDIVIDUAL",
"name": "Maria",
"lastname": "Silva",
"document": { "type": "CPF", "id": "000.000.000-00" }
}
}'Abdeckung
Pay-in-Methoden nach Land
Argentinien
- Virtuelle Konten
- CVU
- Karten
- Ja
- Lokale Methoden
- QR · Debin
Bolivien
- Virtuelle Konten
- —
- Karten
- —
- Lokale Methoden
- QR
Brasilien
- Virtuelle Konten
- Virtuelles Konto (Pix oder TED)
- Karten
- —
- Lokale Methoden
- Pix
Chile
- Virtuelle Konten
- Bankkonto (TEF)
- Karten
- —
- Lokale Methoden
- ETPAY
Kolumbien
- Virtuelle Konten
- Bre-B-Schlüssel
- Karten
- Ja
- Lokale Methoden
- PSE
Costa Rica
- Virtuelle Konten
- IBAN (SINPE)
- Karten
- —
- Lokale Methoden
- —
Guatemala
- Virtuelle Konten
- —
- Karten
- —
- Lokale Methoden
- QR Fri · Wallet Fri
Mexiko
- Virtuelle Konten
- CLABE
- Karten
- Ja
- Lokale Methoden
- —
Peru
- Virtuelle Konten
- CCI
- Karten
- Ja
- Lokale Methoden
- QR
Quelle: Länderleitfäden auf docs.localpayment.com. Die Verfügbarkeit wird für jeden Händler im Onboarding bestätigt.
Anwendungsfälle
Zahlungsannahme für jede Branche
E-Commerce & Marktplätze
Karten, Pix, PSE und SPEI im Checkout, Erstattungen über dieselbe API.
E-Commerce & Marktplätze —Digitale Güter & Streaming
Echtzeit-Schienen bestätigen in Sekunden, Inhalte werden sofort freigeschaltet.
Digitale Güter & Streaming —SaaS
Abonnements lokal einziehen und in Ihrer Hartwährung abrechnen.
SaaS —Reisen
Hohe Beträge per Banküberweisung mit Echtzeitbestätigung.
Reisen —
Häufige Fragen
Was ist meine Abrechnungswährung?
In der Regel USD. Zahlungseingänge in Landeswährung werden Ihrem Localpayment-Konto in Ihrer Abrechnungswährung gutgeschrieben. Lokale Guthaben können Sie innerhalb der lokalen Handelszeiten auch in andere Hartwährungen wie EUR oder GBP umrechnen.
Werden Zahlungen in Echtzeit bestätigt?
Kartenautorisierungen erfolgen in Echtzeit. Echtzeitsysteme wie Pix, SPEI, COELSA, TEF, CCE und Bre-B bestätigen in Sekunden, rund um die Uhr. Andere Methoden bestätigen asynchron; jeder finale Status kommt per Webhook.
Woran erkenne ich, dass eine Zahlung abgeschlossen ist?
Sie erhalten einen mit HMAC-SHA256 signierten Webhook im Header X-Signature. Ein status.code von 200 bedeutet COMPLETED. Alternativ fragen Sie GET /api/transactions/{externalId}/status ab.
Kann ich eine Zahlung erstatten?
Ja. Karten-, virtuelle-Konten- und APM-Zahlungen lassen sich über die API oder das Business Portal erstatten.
Brauche ich pro Land eine eigene Integration?
Nein. Die Request-Struktur ist überall gleich; neue Märkte werden per Konfiguration freigeschaltet, ohne erneute Integration.
Wie beginne ich mit dem Testen?
Stage-Zugangsdaten erhalten Sie zu Beginn der Partnerschaft. Stage spiegelt die Produktion ohne echtes Geld, sodass Sie jeden Ablauf vor dem Go-live testen können.
Welche Zahlungsmethoden kann ich in den einzelnen Ländern anbieten?
Karten in Argentinien, Kolumbien, Mexiko und Peru sowie virtuelle Konten und lokale Zahlungsmethoden (APMs), soweit je Land dokumentiert. Das Verzeichnis der Zahlungsmethoden listet jede Methode mit Code und Geschwindigkeit; Ihr Account-Team schaltet sie per Konfiguration frei.
Kann ich in US-Dollar einziehen?
In einigen Märkten ja – etwa USD-virtuelle Konten in Costa Rica, Peru und Mexiko (über SPID). In den meisten Ländern zahlt der Zahler in Landeswährung und der Betrag wird Ihrem Konto in Ihrer Abrechnungswährung gutgeschrieben.
Ebenfalls über dieselbe API
Virtuelle Konten
Eine eindeutige lokale Kontonummer pro Kunde, automatisch abgeglichen.
Virtuelle Konten —Payouts
Auszahlungen auf Bankkonten über lokale Zahlungssysteme in 14 Ländern und auf Wallets in 9 Ländern.
Payouts —Abgleich & Reporting
Berichte, APIs und Webhooks für Finanzteams.
Abgleich & Reporting —
Starten Sie mit lokalem Inkasso
Erhalten Sie Stage-Zugangsdaten zu Beginn der Partnerschaft, gehen Sie in wenigen Wochen live und erschließen Sie neue Märkte per Konfiguration.