CartDNA ist ein Shopify Zahlungsapp-Entwicklungspartner

CartDNA-Logo

CartDNA API

Verwenden Sie die CartDNA API, um sich sicher zu authentifizieren, Zahlungsanfragen zu erstellen, Zahlungsmethoden-Auswahl zu steuern und Ihre Systeme durch Callback-Workflows aktuell zu halten. Gebaut für Teams, die flexible Zahlungsinfrastruktur und zuverlässige Backend-Kontrolle benötigen.

Was die API Ihnen ermöglicht

Die CartDNA API gibt Ihnen die Kernaktionen, die für Zahlungsorchestierung benötigt werden. Sie können ein Zugangs-Token anfordern, Zahlungsanfragen einreichen, Kunden- und Bestelldaten definieren, unterstützte Zahlungsmethoden wählen und Status-Updates über Callback-URLs erhalten.

Wichtige API-Funktionen

Authentifizierung

Verwenden Sie Client-Anmeldedaten, um ein Zugangs-Token anzufordern und fügen Sie dieses Token dann in autorisierten Anfragen hinzu.

Zahlungserstellung

Erstellen Sie Zahlungsanfragen mit Bestelldetails, Betrag, Währung, Kundendaten und Zahlungsmethoden-Auswahl.

Sicherheitskontrollen

Schützen Sie jede Anfrage mit Zeitstempel-Validierung, Idempotenz-Schlüsseln und Anfrage-Signaturen.

Kunden-Weiterleitungsflow

Verwenden Sie die zurückgegebene Zahlungs-URL, um Kunden in das Zahlungserlebnis zu senden.

Callback-gesteuerte Updates

Erhalten Sie Zahlungsupdates in Ihrem Backend, damit Ihr Bestellsystem genau bleibt.

Gebaut für echte Transaktionsflows

CartDNA API-Anfragen unterstützen gängige Transaktionsaktionen wie Zahlungserstellung und Vorautorisierungs-ähnliche Flows, abhängig von Ihrer Händler-Einrichtung. Dies gibt Entwicklern Flexibilität bei der Handhabung von direkten Captures, gestaffelten Zahlungen oder methodenspezifischer Checkout-Logik.

Lokale und globale Zahlungsunterstützung

Die öffentliche API-Referenz zeigt Unterstützung für mehrere Zahlungsmethoden und Währungen, einschließlich Karten und ausgewählte lokale Methoden. Dies gibt Händlern mehr Flexibilität beim Verkauf über Märkte hinweg und hilft Entwicklern, Zahlungserlebnisse zu erstellen, die Kundenerwartungen entsprechen.

Beispiele:

  • Karten für breite globale Abdeckung
  • Bancontact für Belgien
  • Boleto und Pix für Brasilien
  • Klarna für ausgewählte internationale Märkte
  • Przelewy24 für Polen

Sicherheit steht an erster Stelle

CartDNA verwendet geschichteten Anfrageschutz. Tokens kontrollieren API-Zugriff. Zeitstempel helfen, Replay-Probleme zu reduzieren. Idempotenz-Schlüssel reduzieren versehentliche Duplikate. Signaturen schützen kritische Zahlungsfelder vor Manipulation. Diese Struktur ist praktisch für Produktionssysteme, wo Zahlungszuverlässigkeit wichtig ist.

Planen Sie vorhersehbare Fehlerzustände ein

Ihre Integration sollte häufige API-Fehlerfälle wie ungültige Tokens, abgelaufene Anfragen, doppelte Anfragen und ungültige Signaturen behandeln. Erstellen Sie klare Wiederholungen, wo sicher, protokollieren Sie Anfrage-Kontext und zeigen Sie hilfreiche interne Fehlermeldungen für Support-Teams.

Wie man sauber entwickelt

Alle Secrets serverseitig aufbewahren

UUID-Idempotenz-Schlüssel verwenden

Bestell-ID-Formate standardisieren

Callback-Zustellungen protokollieren

Weiterleitungsergebnisse mit finalem Backend-Status abgleichen

Sandbox- und Live-Anmeldedaten trennen

Signatur-Generierung mit festen Payload-Samples testen

Brauchen Sie Endpunkt-Details?

Für exakte Header, Anfrage-Beispiele, Payload-Felder und Antwort-Formate verwenden Sie die vollständige CartDNA API-Referenz.

Zur API-Referenz gehen