Zum Hauptinhalt springen

Zahlungsablauf

Die Hero API ist so konzipiert, dass sie einfach, effizient und sicher ist.

Definitionen​

Bevor du die Erklärungen unseres Zahlungsablaufs liest, ist es wichtig, einige Definitionen im Kopf zu haben:

  • Kunde: deine Kunden
  • Zahlungsart: die Art und Weise, wie Kunden Hero bezahlen. Für unsere Verarbeitungslösung kann dies nur in 1 Rate, sofort erfolgen.

Erklärungen​

Hier ist ein Schema unseres Zahlungsablaufs: Zahlungsablauf

Schritt 1-a: CreatePayment-Anfrage​

Wenn der Kunde sich entscheidet, mit Hero an deiner Kasse zu bezahlen, sollte dein Back-End createPayment anfordern.

In diesem Schritt solltest du einige Informationen angeben, wie z.B. einen Weiterleitungs-URI. Der Kunde wird zu diesem URI weitergeleitet, wenn seine Zahlung bestätigt ist.

Sicherheit

Aus Sicherheitsgründen überprüfen wir den Wert des Weiterleitungs-URI. Zum Beispiel wird eine Anfrage mit URI, die auf .localhost endet, blockiert. Verwende einen unverdächtigen Weiterleitungs-URI 😇

Schritt 1-b: Rückgabe der Zahlungs-ID​

Hero gibt dir die Zahlungs-ID (beginnt mit payment_id), bitte speichere sie, du wirst sie brauchen.

Schritt 2: Weiterleitung zur Zahlungsseite mit Zahlungs-IDpayment-flow#step-4-redirect-to-payment-page-using-payment-id)​

Jetzt hast du die Zahlungs-ID, du kannst den Kunden zu diesem URI weiterleiten:

  • Produktion: https://pay.heropay.eu/checkout/{payment_id}
  • Staging: https://staging.pay.heropay.eu/checkout/{payment_id}

Dein Kunde zahlt jetzt über Hero!

Wenn du unseren Zahlungsablauf im Staging testen möchtest, verwende die folgenden Karteninformationen:

Kartennummer: 4010061700000021
Ablaufdatum: 12/26
CVV: 123

Schritt 3: Zahlung​

Dein Kunde zahlt auf unserer Zahlungsseite. Seine Karteninformationen werden sicher verarbeitet.

Schritt 4: Weiterleitung​

Dein Kunde hat die Zahlung abgeschlossen und wird zu deinem Weiterleitungs-URI weitergeleitet, um seine Bestellung auf deiner Website zu bestätigen.

Schritt 5-a: Aufruf von getPaymentsInfos​

Du kannst die Zahlungsinformationen überprüfen, um zu wissen, ob eine Zahlung initiiert wurde oder nicht, und um zu wissen, ob ein Betrag zurückerstattet wurde oder wird.

Rufe den getPaymentsInfos-Endpunkt mit der passenden payment_id auf und dann:

Schritt 5-b: Überprüfung der Zahlungsinformationenpayment-flow#step-6--check-the-payments-informations)​

Unser Back-End gibt dir die relevanten Informationen für diese Zahlung:

  • Wenn die Zahlung initiiert wurde, bedeutet das, dass der Kunde bezahlt hat
  • Wenn ein Fehler vorliegt, informiere den Kunden, dass die Zahlung nicht abgeschlossen werden kann, und kontaktiere unseren Support unter support@hero.fr für weitere Informationen. Die Zahlung wurde nicht abgeschlossen und der Kunde sollte versuchen, erneut zu bezahlen.