Checkout

Grundlage eines jeden Bezahlvorgangs bildet der Checkout. Ein Checkout repräsentiert somit den gesamten Zahlungsvorgang. Hier wird zwischen den Typen Einmalzahlung (DIRECT_SALE) und Vorbestellung (ORDER / ORDER_SECURED) unterschieden. An einen Checkout können unterschiedlichste Parameter übergeben werden die diesen individualisieren und unterschiedlichste Eigenschaften bzw. Verhaltensweisen ermöglichen. Je nach Bedarf können Sie als Händler so den für Sie passenden Checkout generieren und für den Bezahlvorgang nutzen. An einen Checkout gekoppelt sind sämtliche Vorgänge wie Zahlungen und Rückzahlungen. Ein Checkout kann ausschließlich über Ihr Shopsystem bzw. die API angelegt werden, nicht über das Händlerportal.

checkoutId

Jeder Checkout besitzt nach Anlage im paydirekt System eine eindeutige checkoutId über die dieser identifiziert werden kann. Für folgende Aktionen die Sie auf einem Checkout ausführen möchten (Captures, Refunds, etc.) ist diese chckoutId zur Identifikation unerlässlich.

Checkout Parameter

Die Bestandteile eines Checkouts, lassen sich lediglich bei dessen Anlage definieren. Eine nachträgliche Anpassung der durch den Händler definierten Parameter ist nur bedingt möglich (deliveryInformation, merchantInvoiceReferenceNumber).

Eigenschaften eines Checkouts
Bestandteile eines Checkouts
(bei Checkout-Anlage zu definieren)
  • Checkout-Type (type)
  • Gesamtbetrag der Bestellung (totalAmount).
  • Versandkosten der Bestellung (shippingAmount).
  • Warenwert der Bestellung, ohne Versandkosten (orderAmount).
  • Rückzahlungen. Maximal zurückzahlbarer Betrag als Prozentwert (refundLimit).
  • Flag für Overcapture-Checkouts. Bei einem Overcapture-Checkout darf die Summe der Captures den Warenwert der Bestellung um bis zu 10% übersteigen (overcapture).
  • Die Währung des Gesamtbetrags. Derzeit wird nur EUR unterstützt (currency).
  • Warenkorbartikel (items)
  • Warenkorbtyp
  • Lieferadresse
  • Teilzahlungen
  • Redirect-URLs
  • Callback-URLs
  • ...
  • optionale Parameter
Eigenschaften eines Checkouts
  • Wird über die checkoutId identifiziert (Vergabe durch paydirekt)
  • Hat eine standardmäßige Gültigkeit von 30 Minuten (Kann über den Parameter expiryTime angepasstwerden)

Weitere Infomationen zu einzelnen Parametern finden Sie in unserer API-Schnittstellenbeschreibung.