Authorize.Net

Was Sie brauchen

Die API Login ID und der Transaction Key gehören immer zusammen. Der Signature Key ist unabhängig.

Warum wir nach jedem Feld fragen

API Login ID

Benennt Ihr Konto bei API-Aufrufen. Sie funktioniert nur, wenn sie mit dem Transaction Key gepaart ist.

Transaction Key

Das Geheimnis, das beweist, dass eine API-Anfrage Ihre ist. Mit der API Login ID lässt es uns das gehostete Zahlungsformular bauen, sodass die Belastung über Ihr Konto läuft.

Signature Key

Beweist, dass ein eingehender Webhook echt von Authorize.Net stammt, sodass niemand ein "bezahlt"-Ereignis fälschen kann. Es ist ein vom Transaction Key getrennter Wert.

Erfolgs- und Abbruch-URL

Schlichte Einstellungen: wohin der Käufer nach dem Zahlen oder Abbrechen landet. Nicht geheim.

Einrichten

1. Ein kostenloses Sandbox-Konto erstellen (keine Zahlung)

   Sie brauchen kein bezahltes Händlerkonto zum Testen. Authorize.Net bietet einen kostenlosen Sandbox, der die Produktion spiegelt, ohne Kreditkarte.

   1. Gehen Sie zu developer.authorize.net/hello_world/sandbox.html und registrieren Sie sich für ein Sandbox-Konto. Nutzen Sie diesen Link, nicht die Hauptregistrierung oder die Preisseite (das ist die bezahlte Live-Anwendung).
   2. Melden Sie sich beim Sandbox Merchant Interface unter sandbox.authorize.net an.

   Das Signaturschema ist identisch mit der Produktion, sodass alles, was Sie im Sandbox verifizieren, sich live genauso verhält.

2. Ihre drei Zugangsdaten kopieren

   Derselbe Pfad in Sandbox und Live: Account → Settings → Security Settings → General Security Settings → API Credentials and Keys.

   • Die API Login ID wird oben gezeigt.
   • Transaction Key: wählen Sie "New Transaction Key", bestätigen Sie und kopieren Sie ihn sofort (er wird einmal gezeigt).
   • Signature Key: wählen Sie "New Signature Key", bestätigen Sie und kopieren Sie ihn umgehend.

   ⤢
3. Den Webhook hinzufügen
   1. Account → Settings → Business Settings → Webhooks, fügen Sie einen Endpunkt hinzu.
   2. Setzen Sie die Endpunkt-URL auf die Webhook-Adresse Ihres Projekts (unten).
   3. Abonnieren Sie Ereignisse. Einmalzahlungen: net.authorize.payment.authorization.created, authcapture.created, capture.created, priorAuthCapture.created, refund.created, void.created und die fraud.*-Ereignisse (held, approved, declined). Abos (Automated Recurring Billing): die net.authorize.customer.subscription.*-Ereignisse. Verlängerungen kommen als authcapture.created an, bereits abgedeckt. Zusätzliche Ereignisse sind harmlos.
   4. Speichern. Authorize.Net signiert jede Zustellung mit Ihrem Signature Key.

   https://api.coinmoebius.com/webhook/authorizenet/<your project id>

   ⤢

   Coin Moebius zeichnet jede Ereignis-ID einmal auf und ignoriert Duplikate, sodass erneut gesendete Webhooks für Sie behandelt werden.

4. Mit Sandbox-Karten testen

   Sandbox-Karten belasten nie eine echte Karte. Nutzen Sie ein beliebiges zukünftiges Ablaufdatum (zum Beispiel 12/2030) und einen beliebigen CVV (3 Stellen, oder 4 für American Express).

   Netzwerk	Karte
   Visa	4111111111111111
   Mastercard	5424000000000015
   American Express	370000000000002
   Discover	6011000000000012

5. Im Dashboard verbinden

   Anbieter hinzufügen → Authorize.Net. Geben Sie die Erfolgs-URL, die Abbruch-URL und die Live-Gruppe ein (API Login ID, Transaction Key, Signature Key). Fügen Sie die optionale Sandbox-Gruppe zum Testen hinzu. Die Sandbox-Gruppe ist ganz oder gar nicht: alle drei Felder oder keines. Live und Sandbox werden getrennt geprüft.

Nachdem Sie verbunden haben

Führen Sie vor dem Live-Gang eine Testzahlung durch:

1. Erstellen Sie ein Produkt und setzen Sie seine Umgebung auf Testing. Das betreibt das Produkt mit Ihren Sandbox-Zugangsdaten, sodass Sie eine volle Bestellung aufgeben können, ohne Geld zu bewegen. (Wenn Sie den Sandbox-Satz übersprungen haben, fällt ein Testing-Produkt auf Live zurück, fügen Sie ihn also zuerst hinzu.)
2. Setzen Sie den Buy-Button auf eine Seite (eine lokale HTML-Datei reicht), die auf Ihr Projekt zeigt.
3. Schließen Sie den Checkout mit einer Sandbox-Testkarte von oben ab.
4. Öffnen Sie den Reiter Transaktionen. Eine neue Zeile erscheint, mit Testing markiert. Wenn ihr Status succeeded erreicht, funktionieren Ihre Zugangsdaten und der Webhook beide von Ende zu Ende.

Schalten Sie die Umgebung des Produkts auf Live, wenn Sie für echte Zahlungen bereit sind.

Fehlerbehebung

Beginnen Sie mit Verifizieren. Klicken Sie im Dashboard Verifizieren (oder Testdaten verifizieren für den Sandbox-Satz), um Ihre API Login ID und Ihren Transaction Key zu prüfen.

Verifizieren schlägt fehl.

Die API Login ID und der Transaction Key müssen das Paar aus demselben Konto sein (live oder Sandbox). Kopieren Sie beide erneut.

Signaturprüfung schlägt fehl.

Der Signature Key ist ein anderer Wert als der Transaction Key. Kopieren Sie den Signature Key vom selben Bildschirm. Das Schema ist in Sandbox und Live identisch.

Zahlung wird abgeschlossen, aber die Bestellung bleibt ausstehend.

Bestätigen Sie, dass die Webhook-URL genau übereinstimmt und dass Sie die Zahlungsereignisse abonniert haben.

Ein Testprodukt hat eine Live-Karte belastet.

Ein als Test markiertes Produkt fällt auf Ihre Live-Zugangsdaten zurück, wenn kein vollständiger Sandbox-Satz konfiguriert ist. Fügen Sie alle drei Sandbox-Felder hinzu oder entfernen Sie die Testmarkierung des Produkts.

Bestätigen Sie es von Ende zu Ende.

Authorize.Net pingt nur inaktive Webhooks an: setzen Sie den Endpunkt inaktiv, senden Sie einen Ping, reaktivieren Sie ihn dann und beobachten Sie, wie die Bestellung sich aktualisiert.

Gut zu wissen

Token sind kurzlebig. Das Token des gehosteten Formulars hält etwa 15 Minuten. Wir prägen pro Checkout ein frisches.

Währung. Authorize.Net ist vorwiegend ein US-, USD-Gateway. Nicht-USD hängt von Ihrer Verarbeitervereinbarung ab.

Schlüssel rotieren. Erzeugen Sie jederzeit einen neuen Transaction Key oder Signature Key, fügen Sie ihn dann ein. Geheime Felder bleiben beim Bearbeiten leer.

Fragen? Join our Discord