Skip to main content
POST
/
v1
/
book
Schedule checkout for a trip — returns a checkout URL the user opens to complete payment
curl --request POST \
  --url https://api.example.com/v1/book \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "trip_id": "trip_1048576"
}
'
{
  "session_id": "cs_1048576",
  "checkout_url": "https://book.gojinko.com/checkout?sid=1048576",
  "status": "pending_payment",
  "expires_at": "2026-06-01T13:04:56.000Z",
  "total_amount": {
    "amount": 318.4,
    "value": 123,
    "currency": "USD",
    "decimal_places": 2
  },
  "items": [
    null
  ]
}
Turn a finalized trip into a checkout link the user can pay through. Use it once the trip is set and traveler details are filled in, for example after the user picks a Paris to Tokyo round trip and adds a hotel for the stay. The returned URL is what the user opens in a browser to complete payment.

Authorizations

​
X-API-Key
string
header
required

Body

application/json
​
trip_id
string
required
Example:

"trip_1048576"

Response

Checkout session

​
session_id
string
Example:

"cs_1048576"

​
checkout_url
string
Example:

"https://book.gojinko.com/checkout?sid=1048576"

​
status
string
Example:

"pending_payment"

​
expires_at
string
Example:

"2026-06-01T13:04:56.000Z"

​
total_amount
object
​
items
null[]