Create a payment intent

curl --request POST \ --url https://api.letsway.com/v1/brands/{brandId}/carts/{cartId}/payment_intents \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "data": [ { "sessionTime": "2026-07-14T10:00:00", "participants": [ { "firstName": "Alice", "lastName": "Rivera", "priceTierName": "Participant", "id": "<string>", "emailAddress": "alice@example.com", "phoneNumber": "+15550100", "customQuestionResponses": [ { "questionId": "q-dietary-01", "answer": [ { "value": "vegetarian", "key": "hotel-lobby" } ] } ] } ], "experienceId": "c99f70ee-1c0e-4534-a31a-96d5d966cc4b", "sessionDuration": 60, "couponCode": "SUMMER10", "discountAmount": 10, "discountPercentage": 15, "accessCode": "VIP-2026", "notes": "Guest requested a window seat.", "metadata": {}, "internalNotes": "VIP guest - assign senior host.", "listingAddOns": [], "appliedCreditCodes": [ { "code": "GC-7F3K9QW2", "appliedValue": 25, "sequence": 1 } ], "intendedConfirmationCode": "U7dSqlzCA", "waitlistEntryId": "8a1a2b3c-4d5e-4f6a-8b9c-1d2e3f4a5b6c", "resourceGroupId": "4a7d1e9b-2c5f-4b3a-8e6d-1f9a5c3b7e28", "resourceQuantity": 2 } ] } '

import requests url = "https://api.letsway.com/v1/brands/{brandId}/carts/{cartId}/payment_intents" payload = { "data": [ { "sessionTime": "2026-07-14T10:00:00", "participants": [ { "firstName": "Alice", "lastName": "Rivera", "priceTierName": "Participant", "id": "<string>", "emailAddress": "alice@example.com", "phoneNumber": "+15550100", "customQuestionResponses": [ { "questionId": "q-dietary-01", "answer": [ { "value": "vegetarian", "key": "hotel-lobby" } ] } ] } ], "experienceId": "c99f70ee-1c0e-4534-a31a-96d5d966cc4b", "sessionDuration": 60, "couponCode": "SUMMER10", "discountAmount": 10, "discountPercentage": 15, "accessCode": "VIP-2026", "notes": "Guest requested a window seat.", "metadata": {}, "internalNotes": "VIP guest - assign senior host.", "listingAddOns": [], "appliedCreditCodes": [ { "code": "GC-7F3K9QW2", "appliedValue": 25, "sequence": 1 } ], "intendedConfirmationCode": "U7dSqlzCA", "waitlistEntryId": "8a1a2b3c-4d5e-4f6a-8b9c-1d2e3f4a5b6c", "resourceGroupId": "4a7d1e9b-2c5f-4b3a-8e6d-1f9a5c3b7e28", "resourceQuantity": 2 } ] } headers = { "Authorization": "Bearer <token>", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.text)

Authorizations

Authorization

string

header

required

Your brand's secret API key, e.g. Bearer way_sk_live_bhEqcn0i1fRoUEHBPjJkQA. Older Way-Brand-Id + Way-Secret-Key credentials still work: see Legacy authentication.

Path Parameters

brandId

string

required

The brand's ID - must match the brand your API key identifies (or the Way-Brand-Id header when one is sent).

cartId

string

required

Only bookings created from this cart.

Body

application/json

data

object[]

required

The cart items to price, in the same shape as the book-bulk data[] items. Send the exact items you intend to book so the payment intent amount matches the booking.

Show child attributes

getOnlyTotalNetAmount

boolean

When true, prices the cart and returns totalNetAmount without initializing a payment - paymentIntentSecret comes back null. Use it to show a running total before checkout.

convertToUsd

boolean

default:false

When true and the cart's currency is not USD, prices the cart in USD using Way's conversion rate. Defaults to false.

paymentIntentRevision

number

Monotonically increasing revision number for this cart's payment intent, protecting against stale or duplicate requests: if the value is lower than or equal to the cart's stored revision, Way returns the existing intent instead of updating it. Omit if you only create the intent once per cart.

Example:

1

Response

201 - application/json

totalNetAmount

number

required

Total amount to charge for the cart after discounts and credits, in the brand's currency (USD when convertToUsd is true). Matches the amount the booking call will charge if the cart is unchanged.

Example:

200

paymentIntentSecret

string | null

required

Stripe client secret for the created payment intent - use it to initialize Stripe Elements. Null when getOnlyTotalNetAmount is true. The booking response's clientSecret is the definitive secret to confirm the charge against.

Example:

"pi_3Tso72FpAKNo2Ml2_secret_REDACTED"