Im Fall einer API-Direktanbindung ist JSON das gültige Kommunikationsformat zum paydirekt System. Speziell bei der Checkout-Anlage stehen Ihnen als Händler bei jeder Datenübertragung eine Vielzahl an Funktionen wie zum Beispiel Altersbeschränkung, Refundhöhe, Overcaptures uvm. zur Verfügung. Diese sollen Ihnen die Möglichkeit bieten, den Checkout bestmögich auf Ihre Produkteigenschaften anzupassen.
Der Checkout Konfigurator unterstützt Sie dabei, ein gültiges JSON-Objekt zu erstellen. Dabei geht es primär um die Abhängigkeiten verschiedener Parameter untereinander, sowie um deren Besonderheiten. Diese werden Ihnen als Hinweis angezeigt. Bitte beachten Sie, dass der Konfigurator kein gültiges JSON-Objekt für Ihren individuellen Checkout generiert, sondern lediglich exemplarische Daten ausliefert. Das im JSON-Result dargestellte JSON-Objekt ist vollständig, muss jedoch durch Ihre shopspezifischen Daten (z.B. Warenwerte, Versandkosten, Bestellnummer, URLs etc.) ergänzt werden um gültig zu werden.
Möchten Sie das Käuferkonto durch eine einmalige Abbuchung des Gesamtbetrages (DIRECT_SALE) oder durch mehrere einzelne Teilzahlungen (Vorbestellungen) belasten (ORDER, ORDER_SECURED)?
Teilzahlungen machen zum Beispiel dann Sinn, wenn Sie Teilmengen einer Bestellung erst zu späteren Zeitpunkten versenden und auch erst dann das Käuferkonto belasten möchten.
Soll die Gültigkeit des Checkout von den standardmäßigen 30 Minuten abweichen?
Wir empfehlen die Einhaltung der Standardzeit von 30 Minuten (1800 Sekunden). In Einzelfällen kann eine verkürzte Gültigkeit des Checkouts Sinn machen. Im Speziellen bei hoher Nachfrage oder kurzer Angebotszeit eines Artikels (z.B. Tickets) kann die Gültigkeit bis auf 2 Minuten (120 Sekunden) verkürzt werden.
Bis zu welcher Höhe (% des Bestellwertes) möchten Sie Refunds zu dieser Bestellung zulassen?
Der Defaultwert beträgt 200%.
Handelt es sich um Waren dessen Warenpreis sich zum Zeitpunkt der Bestellung noch nicht zu 100% feststellen lässt? Z.B. bei Wiegewaren.
Bei einem Overcapture-Checkout darf die Summe der Captures den Warenwert der Bestellung um bis zu 10% übersteigen.
Um die Overcapture Funktionalität nutzen zu können muss diese von paydirekt für Ihren Händleraccount aktiviert werden. Bitte vermerken Sie diese Anforderung daher bereits beim Ausfüllen Ihres Händlerantrages oder lassen Sie diese nachträglich aktivieren.
Um welche Art von Gütern handelt es sich bei der Bestellung?
Der Warenkorbtyp kategorisiert den Warenkorb eines Checkouts anhand der Eigenschaften der enthaltenen Güter. Der Standardwert ist Physisch und Digital (MIXED).
| Physisch (PHYSICAL) |
Der Warenkorb enthält ausschließlich physische Güter |
|---|---|
| Digital (DIGITAL) |
Der Warenkorb enthält ausschließlich digitale Güter |
| Physisch und Digital (MIXED) |
Der Warenkorb enthält sowohl phyische als auch digitale Güter |
| Anonyme Spende (ANONYMOUS_DONATION) |
Beim Warenkorb handelt es sich ausschließlich um eine anonyme Spende |
| Behördenzahlungen (AUTHORITIES_PAYMENT) |
Beim Warenkorb handelt es sich ausschließlich um Behördenzahlungen |
Möchten Sie Warenkorbartikel im Checkout übermitteln?
Die Übertragung der Warenkorbartikel ist optional. Wir empfehlen jedoch zur besseren Fraudprävention den Warenkorb an das paydirekt System zu übermitteln.
"items" : [
{
"quantity" : 3,
"name" : "Bobbycar",
"ean" : "800001303",
"price" : 25.99
},
{
"quantity" : 1,
"name" : "Helm",
"price" : 18.53
}
],
Um welche Art von Bestimmungsort handelt es sich bei der Bestellung?
Sollten Sie die Option Express-Checkout gewählt haben ist nur der "deliveryType" : "STANDARD" (Postadresse) zulässig.
Möchten Sie weitere Informationen zur Lieferung angeben?
Dies können Informationen wie das Versanddatum, Paket-Dienstleister oder Sendungsnummer sein.
{ "expectedShippingDate" : "2016-10-19T12:00:00.000Z", "logisticsProvider" : "DHL", "trackingNumber" : "1234567890"
}
Gibt es ein Mindestalter um die Bestellung als Käufer durchführen zu dürfen?
{
"type" : "DIRECT_SALE",
"requestedPreauthorizationValidity" : "",
"express" : false,
"webUrlShippingTerms" : "",
"refundLimit" : 200,
"overcapture" : false,
"shoppingCartType" : "MIXED",
"minimumAge" : 18,
"redirectUrlAfterAgeVerificationFailure" : "",
"expiryTime" : 1800,
"deliveryType" : "STANDARD",
"deliveryInformation" : {
"expectedShippingDate" : "2016-10-19T12:00:00.000Z",
"logisticsProvider" : "DHL",
"trackingNumber" : "1234567890"
},
"shippingAddress" : {
"addresseeGivenName" : "Marie",
"addresseeLastName" : "Mustermann",
"company" : "Musterbau GmbH & Co KG",
"street" : "Kastanienallee",
"streetNr" : "999",
"additionalAddressInformation" : "Im Rückgebäude",
"zip" : "90402",
"city" : "Schwaig",
"countryCode" : "DE",
"state" : "Bayern"
},
"totalAmount" : 100.0,
"shippingAmount" : 3.5,
"orderAmount" : 96.5, "items" : [ {
"quantity" : 3,
"name" : "Bobbycar",
"ean" : "800001303",
"price" : 25.99
}, {
"quantity" : 1,
"name" : "Helm",
"price" : 18.53
} ],
"currency" : "EUR",
"merchantCustomerNumber" : "cust-732477",
"merchantOrderReferenceNumber" : "order-A12223412",
"merchantReconciliationReferenceNumber" : "recon-A12223412",
"merchantInvoiceReferenceNumber" : "20150112334345",
"note" : "Ihr Einkauf bei Spielauto-Versand.",
"redirectUrlAfterSuccess" : "https://spielauto-versand.de/order/123/success",
"redirectUrlAfterCancellation" : "https://spielauto-versand.de/order/123/cancellation",
"redirectUrlAfterRejection" : "https://spielauto-versand.de/order/123/rejection",
"callbackUrlStatusUpdates" : "https://spielauto-versand.de/callback/status"
}