> ## Documentation Index > Fetch the complete documentation index at: https://docs.henrylabs.ai/llms.txt > Use this file to discover all available pages before exploring further. # Cart Purchase > Initiate the purchase process for a cart. Requests are async by default, or use mode=sync to wait up to 30 seconds for completion. ## OpenAPI ````yaml https://app.stainless.com/api/spec/documented/henry-sdk/openapi.documented.yml post /cart/{cartId}/purchase openapi: 3.1.0 info: title: Henry Labs API version: 1.5.0 description: Playground for Henry Labs API endpoints contact: name: Henry Labs API Support email: support@henrylabs.ai servers: - url: https://api.henrylabs.ai/v1 description: Production server security: - ApiKeyAuth: [] tags: - name: Product description: Product search, details, and data enrichment - name: Cart description: Universal user shopping cart management - name: Orders description: Order management post purchase - name: Merchants description: Merchant information and status paths: /cart/{cartId}/purchase: post: tags: - Cart summary: Cart Purchase description: >- Initiate the purchase process for a cart. Requests are async by default, or use mode=sync to wait up to 30 seconds for completion. operationId: cartPurchase parameters: - in: path name: cartId schema: type: string description: Unique identifier for the cart example: crt_sa2aEsCz9PRM required: true description: Unique identifier for the cart requestBody: content: application/json: example: buyer: name: firstName: John middleName: A. lastName: Doe email: johnadoe@example.com phone: '+1234567890' shippingAddress: line1: 123 Main St line2: Apt 4B city: Anytown province: CA postalCode: '12345' countryCode: US card: nameOnCard: firstName: John middleName: A. lastName: Doe details: cardToken: card_live_SimDpKU9cmU7tvdUXHzOeLudtgfadQVnbof billingAddress: line1: 123 Main St line2: Apt 4B city: Anytown province: CA postalCode: '12345' countryCode: US mode: async schema: $ref: '#/components/schemas/cartPurchaseInput' responses: '201': description: >- Cart purchase queued successfully, use refId to check status and retrieve results content: application/json: schema: $ref: '#/components/schemas/cartPurchaseStatusResponse' '400': description: Bad request - Invalid parameters content: application/json: schema: type: object properties: success: type: boolean status: type: string message: type: string required: - success - status - message additionalProperties: false '401': description: Unauthorized - Invalid API key content: application/json: schema: type: object properties: success: type: boolean status: type: string message: type: string required: - success - status - message additionalProperties: false security: - ApiKeyAuth: [] x-codeSamples: - lang: JavaScript source: >- import HenrySDK from '@henrylabs/sdk'; const client = new HenrySDK({ apiKey: process.env['HENRY_SDK_API_KEY'], // This is the default and can be omitted }); const response = await client.cart.checkout.purchase('crt_sa2aEsCz9PRM', { buyer: { name: { firstName: 'John', middleName: 'A.', lastName: 'Doe', }, email: 'johnadoe@example.com', phone: '+1234567890', shippingAddress: { line1: '123 Main St', line2: 'Apt 4B', city: 'Anytown', province: 'CA', postalCode: '12345', countryCode: 'US', }, card: { nameOnCard: { firstName: 'John', middleName: 'A.', lastName: 'Doe', }, details: { cardToken: 'card_live_SimDpKU9cmU7tvdUXHzOeLudtgfadQVnbof' }, billingAddress: { line1: '123 Main St', line2: 'Apt 4B', city: 'Anytown', province: 'CA', postalCode: '12345', countryCode: 'US', }, }, }, mode: 'async', }); console.log(response.details); components: schemas: cartPurchaseInput: type: object properties: mode: description: >- Response mode. Use sync to wait up to 30 seconds for the backing worker flow to complete. example: async type: string enum: - async - sync overrideProducts: $ref: '#/components/schemas/overrideProducts' buyer: type: object properties: name: type: object properties: firstName: type: string middleName: type: string lastName: type: string required: - firstName - lastName description: Buyer's full name example: firstName: John middleName: A. lastName: Doe email: type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ description: Buyer's email address example: henry@example.com phone: description: Buyer's phone number example: '+1234567890' type: string shippingAddress: type: object properties: name: type: object properties: firstName: type: string middleName: type: string lastName: type: string required: - firstName - lastName email: type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ phone: type: object properties: countryCode: type: string nationalNumber: type: string e164: type: string country: type: string required: - countryCode - nationalNumber - e164 line1: type: string line2: type: string city: type: string province: type: string postalCode: type: string countryCode: type: string required: - line1 - city - province - postalCode - countryCode description: Shipping address for the cart card: type: object properties: nameOnCard: description: Name on the payment card example: firstName: John middleName: A. lastName: Doe type: object properties: firstName: type: string middleName: type: string lastName: type: string required: - firstName - lastName details: type: object properties: cardToken: type: string description: Tokenized card token for payment example: card_live_SimDpKU9cmU7tvdUXHzOeLudtgfadQVnbof required: - cardToken description: Card details for payment billingAddress: description: Billing address for the card (optional if same as shipping) type: object properties: name: type: object properties: firstName: type: string middleName: type: string lastName: type: string required: - firstName - lastName email: type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ phone: type: object properties: countryCode: type: string nationalNumber: type: string e164: type: string country: type: string required: - countryCode - nationalNumber - e164 line1: type: string line2: type: string city: type: string province: type: string postalCode: type: string countryCode: type: string required: - line1 - city - province - postalCode - countryCode required: - details required: - name - email - shippingAddress - card settings: description: Settings for what information to collect type: object properties: collectEmail: description: Whether to collect the buyer's email address type: boolean collectAddress: description: Whether to collect the buyer's shipping address type: boolean collectPhone: description: Whether to collect the buyer's phone number type: boolean metadata: description: Additional metadata for the request type: object properties: botAuth: description: Bot authentication credentials type: object properties: forterToken: description: Forter token for bot authentication type: string userData: description: User identity and device information type: object properties: ipAddress: description: IP address of the user type: string userAgent: description: User agent string of the user's browser or client type: string required: - buyer cartPurchaseStatusResponse: type: object properties: refId: type: string pattern: ^[a-zA-Z]{3}-ref_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[0-9a-f]{4}$ status: type: string enum: - pending - processing - complete - cancelled products: type: array items: type: object properties: status: type: string enum: - pending - processing - complete - failed link: type: string format: uri affiliateProductLink: type: string format: uri quantity: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 merchant: type: string host: type: string selectedOptions: type: array items: type: string selectedShipping: type: object properties: id: type: string value: type: string additionalProperties: false required: - status - link - quantity - merchant - host additionalProperties: false details: type: object properties: hasAccount: type: boolean name: type: object properties: firstName: type: string middleName: type: string lastName: type: string required: - firstName - lastName additionalProperties: false email: type: string phone: type: object properties: countryCode: type: string nationalNumber: type: string e164: type: string country: type: string required: - countryCode - nationalNumber - e164 additionalProperties: false shippingAddress: type: object properties: name: type: object properties: firstName: type: string middleName: type: string lastName: type: string required: - firstName - lastName additionalProperties: false email: type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ phone: type: object properties: countryCode: type: string nationalNumber: type: string e164: type: string country: type: string required: - countryCode - nationalNumber - e164 additionalProperties: false line1: type: string line2: type: string city: type: string province: type: string postalCode: type: string countryCode: type: string required: - line1 - city - province - postalCode - countryCode additionalProperties: false card: type: object properties: nameOnCard: type: object properties: firstName: type: string middleName: type: string lastName: type: string required: - firstName - lastName additionalProperties: false details: type: object properties: {} additionalProperties: false billingAddress: type: object properties: name: type: object properties: firstName: type: string middleName: type: string lastName: type: string required: - firstName - lastName additionalProperties: false email: type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ phone: type: object properties: countryCode: type: string nationalNumber: type: string e164: type: string country: type: string required: - countryCode - nationalNumber - e164 additionalProperties: false line1: type: string line2: type: string city: type: string province: type: string postalCode: type: string countryCode: type: string required: - line1 - city - province - postalCode - countryCode additionalProperties: false required: - nameOnCard - details additionalProperties: false settings: type: object properties: collectEmail: type: boolean collectAddress: type: boolean collectPhone: type: boolean additionalProperties: false required: - hasAccount - name - card additionalProperties: false result: type: object properties: items: type: array items: type: object properties: productLink: type: string format: uri confirmationNumber: type: string quantity: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 shipping: type: object properties: id: type: string name: type: string cost: type: object properties: value: type: number currency: type: string enum: - USD - EUR - AUD - SGD - TWD - GBP - CAD - MXN - NPR - INR required: - value - currency additionalProperties: false timeEstimate: type: string minDate: type: string maxDate: type: string required: - id - name - cost additionalProperties: false costs: type: object properties: subtotal: type: object properties: value: type: number currency: type: string enum: - USD - EUR - AUD - SGD - TWD - GBP - CAD - MXN - NPR - INR required: - value - currency additionalProperties: false tax: type: object properties: value: type: number currency: type: string enum: - USD - EUR - AUD - SGD - TWD - GBP - CAD - MXN - NPR - INR required: - value - currency additionalProperties: false shipping: type: object properties: value: type: number currency: type: string enum: - USD - EUR - AUD - SGD - TWD - GBP - CAD - MXN - NPR - INR required: - value - currency additionalProperties: false discount: type: object properties: value: type: number currency: type: string enum: - USD - EUR - AUD - SGD - TWD - GBP - CAD - MXN - NPR - INR required: - value - currency additionalProperties: false total: type: object properties: value: type: number currency: type: string enum: - USD - EUR - AUD - SGD - TWD - GBP - CAD - MXN - NPR - INR required: - value - currency additionalProperties: false required: - total additionalProperties: false appliedCoupon: type: object properties: code: type: string savedAmount: type: object properties: value: type: number currency: type: string enum: - USD - EUR - AUD - SGD - TWD - GBP - CAD - MXN - NPR - INR required: - value - currency additionalProperties: false required: - code additionalProperties: false metadata: type: object propertyNames: type: string additionalProperties: {} required: - productLink - confirmationNumber - quantity - costs additionalProperties: false costs: type: object properties: subtotal: type: object properties: value: type: number currency: type: string enum: - USD - EUR - AUD - SGD - TWD - GBP - CAD - MXN - NPR - INR required: - value - currency additionalProperties: false commissionFee: type: object properties: value: type: number currency: type: string enum: - USD - EUR - AUD - SGD - TWD - GBP - CAD - MXN - NPR - INR required: - value - currency additionalProperties: false total: type: object properties: value: type: number currency: type: string enum: - USD - EUR - AUD - SGD - TWD - GBP - CAD - MXN - NPR - INR required: - value - currency additionalProperties: false required: - subtotal - commissionFee - total additionalProperties: false required: - items - costs additionalProperties: false error: type: object propertyNames: type: string additionalProperties: {} required: - refId - status - products - details additionalProperties: false overrideProducts: type: object propertyNames: type: string format: uri additionalProperties: $ref: '#/components/schemas/productOverride' description: >- Per-product overrides keyed by product URL. Items with quantity null or 0 are excluded. example: https://www.nike.com/u/custom-nike-ja-3-by-you-10002205: quantity: 2 productOverride: type: object properties: quantity: description: >- Override quantity for this product. null or 0 excludes the item from the operation. example: 2 anyOf: - type: integer minimum: 0 maximum: 9007199254740991 - type: 'null' selectedShipping: description: >- Shipping option to apply for this product at purchase time. Overwrites the cart item's stored selectedShipping for the resulting order. type: object properties: id: description: >- Merchant-specific shipping option id, typically returned by /cart/{cartId}/details example: SHIP_EXPRESS type: string value: description: Common value of the shipping option example: express type: string description: Per-product override applied at details / purchase time securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key ````