Skip to content
Wink

Checkout

POST
/api/checkout
 
curl --request POST \
  --url https://api.wink.travel/api/checkout \
  --header 'Content-Type: application/json' \
  --header 'Wink-Version: 2.0' \
  --data '{ "shoppingCartIdentifier": "", "customizationIdentifier": "", "redirectUrl": "https://ota.wink.travel/thank-you", "ga4ClientId": "", "ga4SessionId": "", "ga4MeasurementId": "" }'

Creates bookings and Stripe PaymentIntent in a single step.

Parameters

Section titled “ Parameters ”

Header Parameters

Section titled “Header Parameters ”
Wink-Version
string
default: 2.0.0
Allowed values: 2.0

Request Body required

Section titled “Request Body required ”
Media type application/json
object
shoppingCartIdentifier
required

Shopping cart to send to TripPay

string
"" >= 1 characters
Example 
shopping-cart-1
customizationIdentifier

Wink affiliate customization

string
""
Example 
customization-1
redirectUrl
required

Wink affiliate customization

string
default: https://ota.wink.travel/thank-you >= 1 characters
Example 
https://ota.wink.travel/thank-you
ga4ClientId

GA4 client ID extracted from the _ga cookie

string
""
ga4SessionId

GA4 session ID extracted from the ga<CONTAINER_ID> cookie

string
""
ga4MeasurementId

GA4 Measurement ID identifying the data stream (e.g. G-XHFTY1BDSD)

string
""

Responses

Section titled “ Responses ”

200

Section titled “200 ”

OK

Media type application/json
object
clientSecret
required

Stripe PaymentIntent client secret for the payment sheet.

string
"" >= 1 characters
ephemeralKey
required

Stripe EphemeralKey secret for the customer session.

string
"" >= 1 characters
customerId
required

Stripe Customer ID.

string
"" >= 1 characters
groupIdentifier
required

Shared group identifier linking all bookings in this checkout.

string
"" >= 1 characters
bookingCodes
required
Array<string>
>= 1 items
Example 
{
  "clientSecret": "",
  "ephemeralKey": "",
  "customerId": "",
  "groupIdentifier": "",
  "bookingCodes": [
    ""
  ]
}

400

Section titled “400 ”

Bad Request

object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
Example generated
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "https://example.com",
  "properties": {
    "additionalProperty": "example"
  }
}

401

Section titled “401 ”

Unauthorized

Media type */*
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties

403

Section titled “403 ”

Forbidden

Media type */*
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties

500

Section titled “500 ”

Internal Server Error

object
Example generated
{}