Create a payment intent

POST

brands

{brandId}

carts

{cartId}

payment_intents

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
    }
  ],
  "getOnlyTotalNetAmount": true,
  "convertToUsd": false,
  "paymentIntentRevision": 1
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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
      }
    ],
    getOnlyTotalNetAmount: true,
    convertToUsd: false,
    paymentIntentRevision: 1
  })
};

fetch('https://api.letsway.com/v1/brands/{brandId}/carts/{cartId}/payment_intents', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

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
        }
    ],
    "getOnlyTotalNetAmount": True,
    "convertToUsd": False,
    "paymentIntentRevision": 1
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "data": {
    "totalNetAmount": 200,
    "paymentIntentSecret": "pi_3Tso72FpAKNo2Ml2_secret_REDACTED"
  }
}

Authorizations

Authorization

string

header

required

Your brand's secret API key, e.g. Bearer way_sk_live_bhEqcn0i1fRoUEHBPjJkQA. The key names the brand, so a brandId in the path must be your own brand. Older Way-Brand-Id + Way-Secret-Key credentials still work: see Legacy authentication.

Path Parameters

brandId

string

required

The brand's ID. With a brand key this must be your own brand; with an organization key it can be any brand in the organization.

cartId

string

required

The cart's ID, the client-generated UUID used at checkout.

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"

⌘I

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
    }
  ],
  "getOnlyTotalNetAmount": true,
  "convertToUsd": false,
  "paymentIntentRevision": 1
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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
      }
    ],
    getOnlyTotalNetAmount: true,
    convertToUsd: false,
    paymentIntentRevision: 1
  })
};

fetch('https://api.letsway.com/v1/brands/{brandId}/carts/{cartId}/payment_intents', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

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
        }
    ],
    "getOnlyTotalNetAmount": True,
    "convertToUsd": False,
    "paymentIntentRevision": 1
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "data": {
    "totalNetAmount": 200,
    "paymentIntentSecret": "pi_3Tso72FpAKNo2Ml2_secret_REDACTED"
  }
}

Getting started

Listings

Availability

Carts & Checkout

Bookings

Experiences

Brand Configuration

Waitlists

Integrations

Organizations

Create a payment intent

Authorizations

Path Parameters

Body

Response