Zum Inhalt springen

Lokale Zahlungsmethoden

Schaffen Sie Raum für die Zahlungsmethoden, für die Kunden ohnehin ihre Banking-App öffnen.

Konto-zu-Konto-Überweisungen und QR-Codes, freigegeben im Online-Banking oder in der App des Zahlers, dazu Wallet Fri in Guatemala. Keine Kartendaten zu erfassen – und jeder finale Status kommt per signiertem Webhook.

Vertrieb kontaktierenAPM-Dokumentation
  • Pix · PSE · Debin · ETPAY
  • QR in 4 Ländern und Wallet Fri
  • Derselbe Create-Payin-Endpunkt
Abdeckung
KanadaArgentinienChileDominikanische RepublikMexikoUruguayBrasilienBolivienPeruKolumbienPanamaCosta RicaNicaraguaHondurasEl SalvadorGuatemalaEcuadorParaguay
Konto-zu-Konto-Zahlungen in Brasilien und Kolumbien
Pix · PSE
Länder mit QR-Zahlungen: Argentinien, Bolivien, Guatemala und Peru
4
Bankzahlungen in Argentinien und Chile
Debin · ETPAY
Wallet-Zahlungen in Guatemala
Wallet Fri

Zahlungsmethoden

A2A-, QR- und Wallet-Systeme, Markt für Markt

Jede Methode folgt lokalen Regeln und Limits. Ihre Integration bleibt dieselbe.

So funktioniert es

Vier Schritte, ein Endpunkt

  1. 01

    Pay-in anlegen

    Rufen Sie POST /api/payin/ auf und wählen Sie den Methodencode – zum Beispiel 1314 für Pix oder 1936 für PSE.

  2. 02

    QR anzeigen oder weiterleiten

    Zeigen Sie den QR-Code oder die Zahlungsanweisungen an oder leiten Sie den Zahler bei PSE in den Bankablauf weiter.

  3. 03

    Der Zahler gibt frei

    Die Freigabe erfolgt im Online-Banking oder in der App des Zahlers. Keine Kartendaten berühren Ihren Checkout.

  4. 04

    Status per Webhook

    Der finale Status kommt asynchron, signiert mit HMAC-SHA256.

Verzeichnis

Lokale Methoden nach Land

Heute dokumentierte A2A- und QR-Methoden sowie Wallet Fri.

  • Argentinien

    Lokale Methoden
    QR · Debin

  • Bolivien

    Lokale Methoden
    QR

  • Brasilien

    Lokale Methoden
    Pix

  • Chile

    Lokale Methoden
    ETPAY

  • Kolumbien

    Lokale Methoden
    PSE

  • Guatemala

    Lokale Methoden
    QR Fri · Wallet Fri

  • Peru

    Lokale Methoden
    QR

Quelle: Länderleitfäden auf docs.localpayment.com. In Kolumbien wird Bre-B über virtuelle Konten (Bre-B-Schlüssel) vereinnahmt. Die Verfügbarkeit wird für jeden Händler beim Onboarding bestätigt.

Betrieb

Asynchron konzipiert, abgeglichen wie alles andere

Lokale Methoden bestätigen, wenn der Zahler freigibt – nicht, wenn Sie den Request senden. Wir verfolgen die Wartezeit und benachrichtigen Sie einmal, mit einem signierten finalen Status.

  • Signierte Webhooks mit X-Signature: HMAC-SHA256
  • Stornierung ausstehender Zahlungen vor der Freigabe durch den Zahler
  • Erstattungen für APM-Zahlungen
  • Ein Reportformat zusammen mit Karten und virtuellen Konten
Webhooks für Entwickler

Für Entwickler

PSE mit demselben Request ergänzen

Ändern Sie Land, Währung und paymentMethod.code – der Rest des Requests bleibt gleich. PSE nutzt einen Redirect-Ablauf; die Antwort enthält die URL zum Bankportal des Zahlers.

  • Pix 1314 · PSE 1936 · jede Methode wird über ihren Code gewählt
  • Get Available Payment Methods für einen dynamischen Checkout
  • Ausstehende Zahlungen stornieren oder über die API erstatten
APM-Dokumentation lesen
# Beispielhaft – PSE (Kolumbien), Felder vereinfacht; siehe docs.localpayment.com
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": "c2b8e6d4-0000-4000-8000-000000000019",
    "country": "COL",
    "currency": "COP",
    "amount": 350000,
    "accountNumber": "<your-account-number>",
    "conceptCode": "0001",
    "merchant": { "type": "COMPANY", "name": "Comercio Ejemplo S.A.S.", "merchantId": "<your-merchant-id>" },
    "payer": {
      "type": "INDIVIDUAL",
      "name": "Camila",
      "lastname": "Rojas",
      "document": { "type": "CC", "id": "1000000000" },
      "email": "camila.rojas@example.com"
    }
  }'

Anwendungsfälle

Wo lokale Methoden den Unterschied machen

Häufige Fragen

Was ist eine APM?

Alternative Zahlungsmethoden sind lokale, bankeigene Verfahren: Echtzeit-Banküberweisungen, QR-Verfahren und Konto-zu-Konto-Abläufe. Der Zahler schließt die Zahlung in seiner eigenen Banking- oder Wallet-App ab, ohne Kartendaten einzugeben.

Wie schnell werden Zahlungen bestätigt?

Pix bestätigt in Sekunden, rund um die Uhr. APMs laufen asynchron: Der Zahler gibt außerhalb Ihres Checkouts frei, und jeder finale Status kommt per Webhook.

Kann ich eine APM-Zahlung stornieren oder erstatten?

Ja. Ausstehende Zahlungen lassen sich vor der Freigabe durch den Zahler stornieren, abgeschlossene APM-Zahlungen können erstattet werden.

Wie lange ist eine Debin-Anfrage gültig?

Debin-Anfragen in Argentinien verfallen nach zwei Tagen, wenn der Zahler sie nicht freigibt.

Brauche ich für jede Methode eine neue Integration?

Nein. Alle Methoden nutzen denselben Create-Payin-Endpunkt; Sie ändern Methodencode, Land und Währung.

Wie schließt ein Zahler eine APM-Zahlung ab?

Je nach Methode wird er zu seiner Bank weitergeleitet (PSE), scannt einen QR-Code oder bestätigt eine Anfrage in seiner Banking-App oder in Wallet Fri. Die Seite zu den Checkout-Erlebnissen zeigt jeden Ablauf Bildschirm für Bildschirm.

In welcher Währung wird gezahlt?

In der Landeswährung des jeweiligen Landes – etwa BRL für Pix, COP für PSE und CLP für ETPAY – und gutgeschrieben auf Ihrem Localpayment-Konto in Ihrer Abrechnungswährung.

Ebenfalls über dieselbe API

Bieten Sie die Methoden an, die Lateinamerika bevorzugt

Ermitteln Sie mit unserem Payments-Team die passenden lokalen Methoden für jeden Ihrer Märkte.

Vertrieb kontaktierenAPM-Dokumentation lesen

Wie können wir helfen?

Ihr Exemplar herunterladen

Hinterlassen Sie Ihre Daten und erhalten Sie sofort die vollständige Ausgabe.