Neben den Pflichtangaben beim Anlegen eines Checkouts gibt es zusätzliche, optionale Parameter, über die Sie den Checkout weiter spezifizieren könnern und für Ihre Bedürfnisse anpassen können. Im folgenden finden Sie diese optionalen Parameter und ihre Beschreibung:
| Parameter (API-Parameter) |
Eigenschaften | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Checkout Gültigkeit (expiryTime) |
Dies definiert die Gültigkeit des Checkouts ab Anlage in Sekunden. Bei Nicht-Angabe werden 1800 Sekunden (= 30 Minuten) als Standardwert angenommen. | ||||||||||||
| Overcapture (overcapture) |
Overcapture (nur bei Checkout-Type: ORDER): Dies erlaubt Ihnen den Einzug von Beträgen, die bis zu 10% über dem vom Käufer genehmigten Betrag liegen. Dies ist u. a. hilfreich für Produkte, bei denen der Endpreis zum Zahlungszeitpunkt nicht sicher bestimmt werden kann wie z. B. bei Wiegewaren oder Waren, die Währungsschwankungen unterliegen. Dem Käufer wird ein deutlicher Hinweis über die 10%ige Erhöhungsmöglichkeit seitens des Händlers angezeigt. Eine Nutzung der Overcaptures muss explizit bei paydirekt beantragt werden. Wenden Sie sich hierfür bitte an: haendler@paydirekt.de | ||||||||||||
| Altersverifikation (minimumAge) |
Mit der paydirekt-Altersverifikation können Sie zu jedem Checkout ein minimales Alter angeben, das der Käufer erreicht haben muss. paydirekt kennt jeden Käufer mit seinem (durch die Bank) verifizierten Alter und prüft bei der Zahlung, ob der Käufer das von Ihnen geforderte Alter erreicht hat. Stimmt dies nicht überein, wird die Zahlung abgelehnt. Das Alter selbst wird Ihnen aus Datenschutzgründen nicht angezeigt. | ||||||||||||
| Refundlimit (refundLimit) |
Das Erstattungslimit erlaubt Ihnen, die Höhe von Erstattungen (refunds) in einem Bereich zwischen 100% und 200% anzupassen. Beträge über 100% erlauben Ihnen, dem Käufer höhere Beträge zurückzuerstatten, als Sie von ihm erhalten haben, z. B. zur Erstattung zusätzlicher Portokosten. | ||||||||||||
| Lieferinformationen (deliveryInformation) |
Sie können Ihrem Käufer Informationen zu voraussichtlichem Lieferdatum, Versanddienstleister und Tracking Nummer übermitteln. Diese Informationen werden dem Käufer im Käuferportal zu seinem Checkout angezeigt. Auch im Rahmen des Dispute-Prozesses werden Ihnen diese Informationen angezeigt. | ||||||||||||
| Zahlungsgarantiezeitraum (requestedPreauthorizationValidity) |
Dieser definiert einen Zeitraum von bis zu 15 Tagen für den bei Checkout-Anlage (nur ORDER_SECURED) eine Zahlungsgarantie ausgestellt wird. Beachten Sie, dass dies nur beim Checkout ORDER_SECURED anwendbar ist.
Nach der Frist von 15 Tagen gilt das Verhalten wie bei der ungesicherten Vorbestellung. Während des Zeitraumes für den gesicherten Einzug steht der Betrag dem Käufer auf seinem Bankkonto nicht frei zur Verfügung. Dies ist besonders bei höheren Beträgen zu beachten, wenn nur ein geringer Teil der bestellten Ware davon später auch final gebucht werden soll (Musterauswahlbestellung). |
||||||||||||
| Warenkorb-Type (shoppingCartType) |
Sie können festlegen, welche Produkte im Warenkorb enthalten sind (physische vs. digitale Produkte). So können Sie die Validierung und das Verhalten des Checkouts sowie weiterer Prozesse beeinflussen. Diese Funktion ist besonders für digitale Warenkörbe hilfreich, da in diesem Falle weniger Adressdaten zu übermitteln sind und der Dispute-Prozess für Sie angepasst wird.
Folgende Werte sind hierbei zulässig:
|
Weitere Infomationen zu einzelnen Parametern finden Sie in unserer API-Schnittstellenbeschreibung.
