Confirm checkout

post

https://api.acc.funtrips.io/{stage}/checkouts/{checkout_id}/confirm

Supports guest users.

Confirms a checkout by providing customer details and a payment return URL.
Returns a PSP payment URL to redirect the customer to. After payment the PSP
redirects back to return_url. Supports idempotency via the
Idempotency-Key header.

Events fired

Event	Trigger	Description
`checkouts.CheckoutFulfillmentRegistered`	sync	Fired when the checkout is confirmed and a fulfillment workflow has been registered.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

checkout_id

uuid

required

Body Params

string

required

first_name

string

required

last_name

string

required

street

string

Shipping street name. Required when the checkout contains a physical product; ignored otherwise.

house_number

string

Shipping house number. Required when the checkout contains a physical product; ignored otherwise.

house_number_suffix

string

Optional house-number addition (e.g. "A", "bis").

postal_code

string

Shipping postal code. Required when the checkout contains a physical product; ignored otherwise.

city

string

Shipping city. Required when the checkout contains a physical product; ignored otherwise.

country_code

string

ISO 3166-1 alpha-2 country code of the shipping address (e.g. "NL"). Required when the checkout contains a physical product; ignored otherwise. Resolved to the order system's country on submit.

return_url

uri

required

URL the PSP redirects to after payment.

newsletters

array of strings

List of newsletter IDs the customer opted into.

newsletters

Headers

x-campaign-id

uuid

required

Campaign scope for this request. Filters content to the specified campaign.

Idempotency-Key

uuid

required

Client-generated UUID. Identical keys within the TTL window return the cached response.

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Header

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/problem+json

200Checkout confirmed. Redirect the customer to payment_url.

208The request was already processed. The original response body is returned unchanged. Treat this identically to the normal success response for this endpoint.

400The request body or parameters are invalid.

401Missing or invalid authentication credentials.

404Checkout not found or reservation expired.

422Reservation is no longer valid.

500An unexpected server error occurred.