Karten (Visa & Mastercard)

Überblick

Akzeptieren Sie Kredit- und Debitkartenzahlungen über die Cost+ API mit der Zahlungsmethode credit-card.

{
  "transactions": [
    {
      "payment_method": "credit-card"
    }
  ]
}

Unterstützte Kartenmarken

Marke	Typ
Amex	Kredit
Mastercard	Kredit / Debit
Maestro	Debit
Visa	Kredit / Debit
V Pay	Debit

Konfigurationsoptionen

Dynamischer Deskriptor

Verwenden Sie das Feld dynamic_descriptor, um einen individuellen Auszugstext festzulegen, der auf dem Bank- oder Kartenauszug Ihres Kunden erscheint.

{
  "transactions": [
    {
      "payment_method": "credit-card",
      "payment_method_details": {
        "dynamic_descriptor": "My Store Order 123"
      }
    }
  ]
}

Kundenname als Karteninhabername verwenden

Setzen Sie use_customer_name_as_cardholder_name auf true, um automatisch den Kundennamen aus der Bestellung als Karteninhabernamen zu verwenden.

{
  "transactions": [
    {
      "payment_method": "credit-card",
      "payment_method_details": {
        "use_customer_name_as_cardholder_name": true
      }
    }
  ]
}

Eigenes Karteneingabeformular

Wenn Sie anstelle der gehosteten Zahlungsseite Ihr eigenes Karteneingabeformular erstellen möchten, folgen Sie diesen vier Schritten.

Schritt 1: Bestellung mit Setup-Token erstellen

Erstellen Sie eine Bestellung und fügen Sie setup_token: true in den payment_method_details der Transaktion hinzu. Dies weist Cost+ an, einen Setup-Token zu generieren, mit dem Sie Kartendaten sicher tokenisieren können.

curl -X POST https://api.costplus.online/v1/orders \
  -u your-api-key: \
  -H "Content-Type: application/json" \
  -d '{
    "currency": "EUR",
    "amount": 5000,
    "merchant_order_id": "order-001",
    "transactions": [
      {
        "payment_method": "credit-card",
        "payment_method_details": {
          "setup_token": true
        }
      }
    ],
    "return_url": "https://example.com/return",
    "webhook_url": "https://example.com/webhook"
  }'

Die Antwort enthält einen setup_token-Wert in den payment_method_details der Transaktion:

{
  "id": "order-uuid",
  "transactions": [
    {
      "id": "txn-uuid",
      "payment_method": "credit-card",
      "payment_method_details": {
        "setup_token": "st_abc123..."
      }
    }
  ]
}

Schritt 2: Kartendaten tokenisieren

Senden Sie die Karten-PAN, das Ablaufdatum und den Setup-Token an den Token-Endpunkt. Dies speichert die Karte sicher und gibt einen vault_token zurück.

curl -X POST https://api.costplus.online/v1/tokens/ \
  -H "Content-Type: application/json" \
  -d '{
    "pan": "4111111111111111",
    "expiry_date": "1228",
    "setup_token": "st_abc123..."
  }'

Antwort:

{
  "vault_token": "vt_xyz789..."
}

Schritt 3: Transaktion authentifizieren

Übermitteln Sie den vault_token und die cvc an den Authentifizierungsendpunkt. Wenn 3D Secure erforderlich ist, erhalten Sie eine redirect_url, um den Kunden auf die Authentifizierungsseite seiner Bank weiterzuleiten.

curl -X POST https://api.costplus.online/v1/orders/{order_id}/transactions/{transaction_id}/authenticate/ \
  -u your-api-key: \
  -H "Content-Type: application/json" \
  -d '{
    "vault_token": "vt_xyz789...",
    "cvc": "123"
  }'

Antwort:

{
  "redirect_url": "https://3ds.bank.example.com/auth?id=..."
}

Leiten Sie den Kunden zur redirect_url weiter, um die 3D-Secure-Authentifizierung abzuschließen. Nach Abschluss (oder Abbruch) der Authentifizierung wird der Kunde zurück zu Ihrer return_url weitergeleitet.

Schritt 4: Bestellungsstatus abfragen

Nachdem der Kunde von 3D Secure zurückkehrt, fragen Sie die Bestellung ab, um den endgültigen Status zu überprüfen.

curl -X GET https://api.costplus.online/v1/orders/{order_id} \
  -u your-api-key:

Der Bestellungs-status wechselt zu einem der folgenden:

Status	Bedeutung
`completed`	Zahlung war erfolgreich
`cancelled`	Kunde hat abgebrochen oder Authentifizierung fehlgeschlagen
`error`	Während der Verarbeitung ist ein Fehler aufgetreten
`expired`	Die Bestellung ist vor dem Abschluss abgelaufen

Für manuelle Autorisierungs- und Erfassungsabläufe bei Kartenzahlungen siehe die Anleitung Autorisierung / Erfassung / Stornierung.

On this page