Zum Inhalt springen

Karten

Akzeptieren Sie Kartenzahlungen mit einem Checkout-Ablauf, der auf den Markt zugeschnitten ist.

Akzeptieren Sie Visa und Mastercard in Argentinien, Kolumbien, Mexiko und Peru sowie American Express, Diners Club, Naranja und Cabal, wo dokumentiert. Hinterlegte Karten tokenisieren, mit 3D Secure authentifizieren, Ratenzahlung anbieten und Chargebacks verwalten – über eine Integration.

  • Argentinien · Kolumbien · Mexiko · Peru
  • Visa, Mastercard, Amex, Diners, Naranja, Cabal
  • PEN und USD in Peru
Länder: Argentinien, Kolumbien, Mexiko und Peru
4
Kartenmarken: Visa, Mastercard, Amex, Diners, Naranja und Cabal
6
In Kolumbien, Mexiko und Peru
3D Secure
In Kolumbien, Mexiko und Peru
Ratenzahlung

Netzwerke

Internationale Netzwerke und die lokalen Karten, die Käufer nutzen

Visa und Mastercard in allen vier Märkten, dazu American Express, Naranja und Cabal in Argentinien sowie American Express und Diners Club in Kolumbien, jeweils Kredit- und Debitkarten.

Markt für Markt

Was in jedem Land verfügbar ist

Die Kartenfunktionen unterscheiden sich je nach Markt. Das deckt die Dokumentation heute ab.

  • Argentinien

    Einmalzahlung
    ✓
    Tokenisierung
    ✓
    Erstattungen
    ✓
    Chargebacks
    ✓
    3DS
    —
    Ratenzahlung
    —
    Abonnements
    —
  • Kolumbien

    Einmalzahlung
    ✓
    Tokenisierung
    ✓
    Erstattungen
    ✓
    Chargebacks
    ✓
    3DS
    ✓
    Ratenzahlung
    ✓
    Abonnements
    ✓
  • Mexiko

    Einmalzahlung
    ✓
    Tokenisierung
    ✓
    Erstattungen
    ✓
    Chargebacks
    ✓
    3DS
    ✓
    Ratenzahlung
    ✓
    Abonnements
    ✓
  • Peru

    Einmalzahlung
    ✓
    Tokenisierung
    ✓
    Erstattungen
    ✓
    Chargebacks
    ✓
    3DS
    ✓
    Ratenzahlung
    ✓
    Abonnements
    ✓

Quelle: docs.localpayment.com. In Brasilien werden keine Karten angeboten – nutzen Sie dort Pix und virtuelle Konten mit Pix-Schlüssel.

Funktionen

Alles, was die Kartenakzeptanz braucht

  • Tokenisierung & hinterlegte Karte

    Ersetzen Sie Kartendaten durch einen Token – für wiederkehrende Kunden, schnellere Folgekäufe und Abonnements.

  • 3D Secure

    Starke Kundenauthentifizierung in Kolumbien, Mexiko und Peru. Fordert der Kartenherausgeber eine Challenge an, liefert die API die Challenge-URL.

  • Ratenzahlung

    Ratenplan kalkulieren, den Kunden wählen lassen und belasten – mit Kreditkarten in Landeswährung in Kolumbien, Mexiko und Peru (nur PEN).

  • Vorautorisierung & Capture

    Jetzt autorisieren und später einziehen oder die Reservierung freigeben, wenn die Bestellung nicht zustande kommt. Die Verfügbarkeit je Markt wird im Onboarding bestätigt.

  • Erstattungen

    Erstatten Sie Kartenzahlungen über die API oder das Business Portal und laden Sie Zahlungsnachweise herunter.

  • Chargeback-Management

    Empfangen Sie Chargeback-Webhooks und laden Sie Nachweise innerhalb der Antwortfrist über die API hoch.

Risiko

3D Secure, BIN-Allowlisting und Chargeback-Management

Mehrstufige Kontrollen helfen, betrügerische Transaktionen zu stoppen, bevor daraus Chargebacks werden.

  • 3D Secure

    Authentifizieren Sie Karteninhaber in Kolumbien, Mexiko und Peru. Fordert der Herausgeber eine Challenge an, liefert die API die Challenge-URL.

  • BIN-Allowlisting

    Beschränken Sie die Akzeptanz auf vorab freigegebene BINs, nach Herausgeber und Kartentyp im Business Portal verwaltet.

  • Chargeback-Management

    Erhalten Sie für jeden Chargeback einen Webhook und laden Sie Nachweise vor Fristablauf über die API oder das Business Portal hoch.

PCI-Scope

Rohdaten von Karten von Ihren Servern fernhalten

Erfassen Sie Karten mit Smart Fields, dem eingebetteten iframe oder WebCheckout. Die Kartendaten werden in von uns gehosteten Feldern erfasst und in einen Token umgewandelt, den Ihr Backend mit dem Pay-in sendet.

  • Smart Fields: gehostete Kartenfelder in Ihrer eigenen Oberfläche, per JS-SDK
  • Eingebettetes iframe: ein White-Label-Checkout mit reduziertem PCI-Scope
  • WebCheckout und Zahlungslinks: ohne Code und mit minimalem PCI-Scope
  • TLS 1.2+ bei der Übertragung, AES-256 im Ruhezustand und Schlüsselrotation mit AWS KMS

So funktioniert es

So läuft eine Kartenzahlung ab

  1. 01

    Erfassen

    Der Kunde gibt seine Kartendaten in Smart Fields oder einem gehosteten Checkout ein – oder Sie nutzen einen gespeicherten Token.

  2. 02

    Autorisieren

    Rufen Sie POST /api/payin/ mit paymentMethod.type CreditCard und dem Markencode des Landes auf.

  3. 03

    Bei Bedarf authentifizieren

    Fordert der Herausgeber 3D Secure an, leiten Sie den Kunden zur Challenge-URL aus der Antwort weiter.

  4. 04

    Bestätigen

    Das Ergebnis kommt in Echtzeit und per signiertem Webhook – bereit für Fulfillment und Abgleich.

Für Entwickler

Eine tokenisierte Karte belasten

Senden Sie den Token statt der Kartendaten und verwenden Sie ihn für spätere Belastungen erneut.

  • Markencodes pro Land – zum Beispiel 1600 für Visa in Mexiko
  • Stage-Testkarten für Freigaben, Ablehnungen und 3D Secure
  • Webhooks für Freigaben, Erstattungen und Chargebacks
# Beispielhaft – Felder vereinfacht; den vollständigen Vertrag finden Sie auf 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": "CreditCard", "code": "1600", "flow": "DIRECT" },
    "externalId": "3f9a6c1e-0000-4000-8000-000000000042",
    "country": "MEX",
    "currency": "MXN",
    "amount": 1250.00,
    "accountNumber": "<your-account-number>",
    "conceptCode": "0001",
    "merchant": { "type": "COMPANY", "name": "Comercio Ejemplo S.A. de C.V." },
    "payer": {
      "type": "INDIVIDUAL",
      "name": "Lucía",
      "lastname": "Méndez",
      "document": { "type": "RFC", "id": "XAXX010101000" },
      "email": "lucia.mendez@example.com"
    },
    "card": { "token": "<card-token>" }
  }'

Häufige Fragen

Sind Karten in Brasilien verfügbar?

Nein. Die Kartenakzeptanz umfasst Argentinien, Kolumbien, Mexiko und Peru. In Brasilien vereinnahmen Sie über Pix und virtuelle Konten mit Pix-Schlüssel, die rund um die Uhr in Sekunden bestätigen.

Welche Kartenmarken kann ich akzeptieren?

Visa und Mastercard in allen vier Märkten, dazu American Express, Naranja und Cabal in Argentinien sowie American Express und Diners Club in Kolumbien. Debitkarten werden in allen vier Märkten unterstützt.

Wo sind 3D Secure, Ratenzahlung und Abonnements verfügbar?

In Kolumbien, Mexiko und Peru. Ratenzahlung gilt für Kreditkarten in Landeswährung, in Peru also nur für Zahlungen in PEN. In Argentinien können Sie Einmalzahlungen, Tokenisierung, Erstattungen und Chargeback-Management nutzen.

Wie funktionieren Chargebacks?

Sie erhalten einen Chargeback-Webhook und können Nachweise über die API oder das Business Portal vor der in der Benachrichtigung genannten Frist hochladen. Gehen keine Nachweise rechtzeitig ein, wird der Streitfall in der Regel zugunsten des Karteninhabers entschieden.

Kann ich Kartenabläufe vor dem Go-live testen?

Ja. Stage bietet Testkarten für Freigaben, Ablehnungen, 3D-Secure-Challenges und Verarbeitungsfehler – ohne echtes Geld.

Wie werden Kartendaten geschützt?

Die Daten werden bei der Übertragung mit TLS 1.2+ und im Ruhezustand mit AES-256 verschlüsselt, mit Schlüsselrotation über AWS KMS. Smart Fields und gehostete Checkouts halten Kartenrohdaten von Ihren Servern fern.

Kann ich Karten für spätere Belastungen speichern?

Ja. Tokenisierung ist in Argentinien, Kolumbien, Mexiko und Peru verfügbar. Sie speichern den Token, nie die PAN, und belasten ihn später für Wiederkäufe oder Abonnements.

In welcher Währung werden Kartenzahlungen belastet?

Karten werden in der Landeswährung des jeweiligen Marktes belastet – ARS, COP und MXN, in Peru PEN oder USD – und Ihrem Konto in Ihrer Abrechnungswährung gutgeschrieben.

Karten auf lokale Art akzeptieren

Sprechen Sie mit unserem Team über Kartenakzeptanz in Argentinien, Kolumbien, Mexiko und Peru.

Wie können wir helfen?

Ihr Exemplar herunterladen

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