FAQs
Technische Integration
Wo erhalte ich Zugangsdaten für die Ratenkauf-API?

Wo erhalte ich Zugangsdaten für die Ratenkauf-API?

Für die Anmeldung an der Ratenkauf-API benötigen Sie einerseits eine Webshop-ID und andererseits das dazugehörigen API-Kennwort.

Die Webshop-ID erhalten Sie nach der Anlage Ihrer Vertragsdaten in unserenen Systemen automatisch per E-Mail. Darüber hinaus erhalten Sie einen Link zur Anmeldung im Partnerportal.

Diesen benötigen Sie, um ihr persönliches API-Kennwort im Menüpunkt „Shopadministration“ zu erstellen.

Die Authentifizierung an der API erfolgt mittels BASIC Auth. Hierzu wird bei jedem Request im Header das Attribut Authorization erwartet. Der Wert des Attributs setzt sich wie folgt zusammen:

Der Token berechnet sich aus Webshopkennung (z.B. 2.de.9999.9999) und API-Kennwort. Beides wird mittels : konkateniert und anschließend mittels base64 kodiert.

Zur Anleitung

Momentan ist es nicht vorgesehen, dass der easyCredit-Ratenkauf ohne eine Weiterleitung auf unsere Payment Page integriert werden kann.

Wie kann ich eine abgelehnte Ratenkaufentscheidung testen?

Mit folgenden Kundendaten können Sie eine Ablehnung in der Kreditentscheidung herbeiführen:

Ralf Rotbasis
Beuthener Str. 25
90471 Nürnberg

Bitte beachten: Dies funktioniert nur, wenn Sie eine generelle Test-Webshop-ID nutzen, die mit 2.de.-beginnt. Andernfalls wird eine echte Kreditentscheidung durchgeführt. Es funktioniert nicht mit 1.de.-Kennung und Testmodus.

Kann ich eine eigene Order- / Bestellnummer übertragen zur leichteren Zuordnung?

Ja, Ihre individuelle Bestellnummer aus dem Shopsystem können Sie an uns übertragen, wahlweise entweder bei der Initialisierung oder bei der Bestätigung des Vorgangs. Damit können Sie Ihre Bestellung bspw. im Partner Portal oder bei Abrechnungsdokumenten leichter zuordnen.

In beiden Fällen wird die Bestellnummer im Feld „orderId“ übertragen. Hier exemplarisch bei der Bestätigung (POST ./transaction/{id}/authorization):

{
  "orderId": AGSX1232  // Shopeigene OrderId
}

Reicht es, den Bestätigen-Request nur abzuschicken?

Um zu vermeiden, dass Bestellungen im Shop zwar als erfolgreich angezeigt werden, aber nicht in der Ratenkauf-API abgeschlossen sind, ist es erforderlich, bei der Integration zwei Sicherheitsmechanismen, Statusprüfung & Callback, zu integrieren. Vorher darf der Zahlstatus der Bestllung nicht auf „bezahlt“ gesetzt werden:

Aufruf der Bestellung nach der Bestätigung mit GET ./transaction/{id}. Erst wenn der Status der Bestellung „authorized“ ist, war die Bestellung erfolgreich.
Übergabe einer Callback-URL bei der Initialisierung. Diese wird von unserer API aufgerufen, wenn der Ratenkauf erfolgreich abgeschlossen ist.
```
"redirectLinks": {
    ...
    "urlAuthorizationCallback": "https://www.ihrshop.com/search?=ratenkaufCallback"
  }
```

Wo erhalte ich Zugangsdaten für die Ratenkauf-API?

Ähnliche Fragen