Alle Fragen und Antworten zum Thema Integration

• Bitte prüfen Sie noch einmal, ob die Credentials tatsächlich korrekt sind und mit denen im Partner Portal übereinstimmen
• Haben Sie im Partner Portal die Body Signatur aktiviert? Dann vergessen Sie nicht, dass die Content-Signature im Request-Header übertragen werden müssen.
• Mithilfe des Endpoints POST ./webshop/integrationcheck können Sie prüfen, ob Ihre Integration korrekt funktioniert.
• Evtl. ist Ihre Webshop-ID zentralseitig noch nicht aktiviert. Auch das können Sie über POST ./webshop/integrationcheck prüfen (“message”: “Webshop 1.de.xxxx.3 inactive”). In diesem Fall wenden Sie sich gerne an partner@easycredit.de

Um ein Testbestellungen ohne Bonitätsprüfung etc. durchzuführen haben Sie zwei Möglichkeiten:

1. Sandbox

Zu jeder 1.de.-WebshopID, die Sie von uns erhalten, gibt es auch noch eine parallele WebshopID, die mit “2.de.” beginnt. Wenn Sie diese nutzen, werden alle Bestellungen, als Testbestellungen erkannt – unabhängig davon, welche Kundendaten benutzt werden. Deshalb sollte diese Option möglichst nicht im Produktiv-Betrieb eingesetzt werden. Die 2.de.-WebshopID eignet sich daher eher für Entwicklungsumgebungen, bei denen oft getestet wird und keine Echt-Bestellungen durchgeführt werden.

Für die 2.de.-WebshopID muss über den Schalter “Sandbox” unten in der Shopadministration ein separates API-Kennwort generiert werden.

2. Testmodus

Auch wenn die 1.de.-WebshopID hinterlegt ist, können Testbestellungen durchgeführt werden. Dazu müssen Sie in der Shopadministration für diese WebshopID den Testmodus aktivieren.

Ist das der Fall können mit den Kundendaten Ralf Ratenkauf, Beuthener Str. 25, 90471 Nürnberg Testbestellungen angelegt werden. Alle Bestellungen mit anderen Daten laufen nachwievor als echte Bestellungen inkl. Bonitätsprüfung.

Deshalb eignet sich diese Option besonders für das Testen in der Produktivumgebung, da sie sich auf das restliche Geschäft nicht auswirkt.

• Gewährleistung der technischen Funktionalität. Ratenkäufe müssen End-to-End durchführbar sein.
• Alle relevanten Requests müssen vollständig an unsere API übertragen werden, insbesondere Initialisierung und Bestätigung.
• Anzeige des Datenübermittlungshinweises vor der Weiterleitung des Kunden zur Payment Page
• Bei der Initialisierung müssen die Parameter risikorelevante Angaben & Warenkorbinformationen möglichst vollständig übergeben werden (Pflichtfelder s. API-Dokumentation).
• Anzeige der Zinsen vor dem Bestellabschluss
• Einrechnen der Zinsen in die Gesamtsumme
• Erweitern der AGB mit unseren AGB-Ergänzungen

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

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.

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):

<span class="token punctuation">{</span>
  <span class="token string">"orderId"</span><span class="token operator">:</span> <span class="token constant">AGSX1232</span>  <span class="token comment">// Shopeigene OrderId</span>
<span class="token punctuation">}</span>

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.

  <span class="hljs-attr">"redirectLinks"</span>: {
      ...
      <span class="hljs-attr">"urlAuthorizationCallback"</span>: "https://www.ihrshop.com/search?=ratenkaufCallback"
    }