Checkout POST - Checkout Anlage

Die Checkoutanlage für eine oneKlick Zahlung ist fast gleich aufgebaut wie eine Checkout Anlage für eine 'standard' paydirek Zahlung. Es gibt jedoch zwei Unterschiede:

1. wir brauchen das spezielle 'oneKlick' Access Token - welches wir im vorherigen Punkt erstellt haben.
2. der Parameter 'oneClick' wird auf den Wert 'true' gesetzt und dem POST Request der Checkout Anlage mitgegeben: oneClick=true ;

Die kompletten POST Aufrufe finden Sie in der oneKlick Dokumentation.

oneKlick Checkout - Response JSON

Im Vergleich zum 'standard' Checkout Response, gibt es drei interessante Unterschiede:

1. Es existiert kein 'approve' Link. Hintergrund und Sinn von oneKlick ist, der Käufer braucht für oneKlick nicht mehr selbst die Zahlung in seinem paydirekt Käuferkonto bestätigen.
2. Der Wert im Feld 'status' hat bereits den Wert 'APPROVED'.
3. Der Parameter 'oneClick' hat den Wert 'true'.


Code Example: oneKlick Checkout Anlage Response (JSON)

{
	"checkoutId": "4b030e23-58bd-4a95-bdd3-59bc5ef5e5e6",
	"type": "DIRECT_SALE",
	"oneClick": true,
	"status": "APPROVED",
	"correlationId": "100743398-00000144",
	"creationTimestamp": "2020-10-22T13:31:38.559Z",
	"totalAmount": 4.88,
	"shippingAmount": 1,
	"orderAmount": 3.88,
	"refundLimit": 100,
	"currency": "EUR",
	"items": [
		{
			"quantity": 125,
			"name": "Bio Heidelbeeren 125g von Biowirt",
			"ean": "ean123",
			"price": 1.89
		},
		{
			"quantity": 500,
			"name": "Mandarinen 500g von LaRit",
			"ean": "ean124",
			"price": 1.99
		}
	],
	"deliveryType": "STANDARD",
	"shippingAddress": {
		"addresseeGivenName": "Max",
		"addresseeLastName": "Mustermann",
		"company": "test co.",
		"street": "Hauptstrasse",
		"streetNr": "1",
		"additionalAddressInformation": "hinterm Haus ablegen",
		"zip": "50411",
		"city": "Koeln",
		"countryCode": "DE",
		"state": "NRW",
		"emailAddress": "max.mustermann@test.de"
	},
	"merchantOrderReferenceNumber": "order1255",
	"merchantCustomerNumber": "cust1255",
	"merchantInvoiceReferenceNumber": "Inv1255",
	"merchantReconciliationReferenceNumber": "Recon1255",
	"note": "Ihr Einkauf bei Spielauto-Versand.",
	"minimumAge": 18,
	"callbackUrlStatusUpdates": "https://spielauto-versand.de/order/123/update",
	"contextInformation": {
		"deviceId": "8adb80f96",
		"deviceFingerprint": "ae8xxxxxxxxxxxxxxxxxxxxxxxe6b5",
		"deviceIpAddress": "123.123.123.123",
		"terminalId": "b9f1c1b7",
		"terminalAddress": {
			"name": "Pumpe 6",
			"company": "Mustermann Tankstellen AG",
			"street": "Hamburger Allee",
			"streetNr": "12A",
			"zip": "60626",
			"city": "Frankfurt M.",
			"countryCode": "DE",
			"state": "Hessen"
		}
	},
	"thirdPartyId": "f29cc93d-270b-4599-8587-9ffe0f62c935",
	"thirdPartyClientId": "10a08b4a-fc26-40ff-8612-5d02e4108b00",
	"thirdPartyClientName": "XY Shop",
	"thirdPartyCustomerAuthorizationId": "bfeb1c44-6045-4880-bfd8-6f2bbd780032",
	"thirdPartyMerchantAuthorizationId": "implicit-f29cc93d-270b-4599-8587-9ffe0f62c935",
	"deliveryInformation": {
		"expectedShippingDate": "2026-10-19T12:00:00.000Z",
		"trackingNumber": "1234567890"
	},
	"expiryTimestamp": "2020-10-22T14:01:38.559Z",
	"_links": {
		"refunds": {
			"href": "https://api.sandbox.paydirekt.de/api/checkout/v1/checkouts/4b030e23-58bd-4a95-bdd3-59bc5ef5e5e6/refunds"
		},
		"updateDeliveryInformation": {
			"href": "https://api.sandbox.paydirekt.de/api/checkout/v1/checkouts/4b030e23-58bd-4a95-bdd3-59bc5ef5e5e6/deliveryInformation"
		},
		"updateMerchantInvoiceReferenceNumber": {
			"href": "https://api.sandbox.paydirekt.de/api/checkout/v1/checkouts/4b030e23-58bd-4a95-bdd3-59bc5ef5e5e6/merchantInvoiceReferenceNumber"
		},
		"self": {
			"href": "https://api.sandbox.paydirekt.de/api/checkout/v1/checkouts/4b030e23-58bd-4a95-bdd3-59bc5ef5e5e6"
		}
	},
	"_embedded": {
		"captures": [
			{
				"type": "CAPTURE_DIRECT_SALE",
				"transactionId": "1fc07a18-bb5c-4a32-9c14-a507d64d6a06",
				"amount": 4.88,
				"finalCapture": true,
				"callbackUrlStatusUpdates": "https://spielauto-versand.de/order/123/update",
				"deliveryInformation": {
				"expectedShippingDate": "2021-10-19T12:00:00.000Z",
				"trackingNumber": "1234567890"
			},
			"status": "SUCCESSFUL",
				"_links": {
					"self": {
						"href": "https://api.sandbox.paydirekt.de/api/checkout/v1/checkouts/4b030e23-58bd-4a95-bdd3-59bc5ef5e5e6/captures/1fc07a18-bb5c-4a32-9c14-a507d64d6a06"
					}
				}
			}
		]
	}
}