Checkout Intents

Confirm checkout intent

Confirm a checkout intent with provided payment information

Confirm means we have buyer's name, address and payment info, so we can move forward to place the order.

post/api/v1/checkout-intents/{id}/confirm

Path parameters

idstring required

The id of the checkout intent to confirm

Request body

Example request

{
  "paymentMethod": {
    "stripeToken": "tok_1RkrWWHGDlstla3f1Fc7ZrhH",
    "type": "stripe_token"
  }
}

Response

The confirmed checkout intent

Example response

{
  "referenceId": "order-1234",
  "constraints": {
    "maxShippingPrice": 500,
    "maxTotalPrice": 100000
  },
  "promoCodes": [
    "SAVE20"
  ],
  "variantSelections": [
    {
      "label": "Size, Color, etc."
    }
  ],
  "buyer": {
    "postalCode": "10001",
    "country": "US",
    "province": "NY",
    "city": "New York",
    "address2": "Apt 1",
    "address1": "123 Main St",
    "phone": "1234567890",
    "email": "john.doe@example.com",
    "lastName": "Doe",
    "firstName": "John"
  }
}

Changes

Changed in 10 of the 48 revisions of this API.1824

Jul 3, 2026cd4a7aa2308b15See the full diff
- ▲
  removed NekudaPaymentMethod PravaPaymentMethod from the paymentMethod request property anyOf list
  request-property-any-of-removed
- ○
  removed NekudaPaymentMethod PravaPaymentMethod from the anyOf[subschema #2: Awaiting Confirmation]/allOf[subschema #2]/paymentMethod response property anyOf list for the response status 200
  response-property-any-of-removed
- ○
  removed NekudaPaymentMethod PravaPaymentMethod from the anyOf[subschema #3: Requires Action]/allOf[subschema #2]/paymentMethod response property anyOf list for the response status 200
  response-property-any-of-removed
- ○
  removed NekudaPaymentMethod PravaPaymentMethod from the anyOf[subschema #4: Placing Order]/allOf[subschema #2]/paymentMethod response property anyOf list for the response status 200
  response-property-any-of-removed
- ○
  removed NekudaPaymentMethod PravaPaymentMethod from the anyOf[subschema #5: Completed]/allOf[subschema #2]/paymentMethod response property anyOf list for the response status 200
  response-property-any-of-removed
- ○
  removed NekudaPaymentMethod PravaPaymentMethod from the anyOf[subschema #6: Failed]/allOf[subschema #2]/paymentMethod response property anyOf list for the response status 200
  response-property-any-of-removed
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 1, 2026f2236504ec756See the full diff
- ○
  added the optional property anyOf[subschema #1: Retrieving Offer]/allOf[BaseCheckoutIntent]/referenceId to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property anyOf[subschema #2: Awaiting Confirmation]/allOf[BaseCheckoutIntent]/referenceId to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property anyOf[subschema #3: Requires Action]/allOf[BaseCheckoutIntent]/referenceId to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property anyOf[subschema #4: Placing Order]/allOf[BaseCheckoutIntent]/referenceId to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property anyOf[subschema #5: Completed]/allOf[BaseCheckoutIntent]/referenceId to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property anyOf[subschema #6: Failed]/allOf[BaseCheckoutIntent]/referenceId to the response with the 200 status
  response-optional-property-added
Jun 8, 20260b28c67737d31See the full diff
- ○
  the security scope checkout_intents:write was added to the endpoint's security scheme bearerAuth
  api-security-scope-added
May 29, 202662bb6bbe00e855See the full diff
- ●
  removed the optional property anyOf[subschema #2: Awaiting Confirmation]/allOf[subschema #2]/offer/developerCommission from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property anyOf[subschema #3: Requires Action]/allOf[subschema #2]/offer/developerCommission from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property anyOf[subschema #4: Placing Order]/allOf[subschema #2]/offer/developerCommission from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property anyOf[subschema #5: Completed]/allOf[subschema #2]/offer/developerCommission from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property anyOf[subschema #6: Failed]/allOf[subschema #2]/offer/developerCommission from the response with the 200 status
  response-optional-property-removed
- ○
  added the optional property anyOf[subschema #2: Awaiting Confirmation]/allOf[subschema #2]/offer/commission to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property anyOf[subschema #3: Requires Action]/allOf[subschema #2]/offer/commission to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property anyOf[subschema #4: Placing Order]/allOf[subschema #2]/offer/commission to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property anyOf[subschema #5: Completed]/allOf[subschema #2]/offer/commission to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property anyOf[subschema #6: Failed]/allOf[subschema #2]/offer/commission to the response with the 200 status
  response-optional-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
May 28, 2026ef0711e6ed595See the full diff
- ○
  added the optional property anyOf[subschema #2: Awaiting Confirmation]/allOf[subschema #2]/offer/developerCommission to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property anyOf[subschema #3: Requires Action]/allOf[subschema #2]/offer/developerCommission to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property anyOf[subschema #4: Placing Order]/allOf[subschema #2]/offer/developerCommission to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property anyOf[subschema #5: Completed]/allOf[subschema #2]/offer/developerCommission to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property anyOf[subschema #6: Failed]/allOf[subschema #2]/offer/developerCommission to the response with the 200 status
  response-optional-property-added
May 13, 20265a2e900cb8541See the full diff
- ●
  removed the optional property anyOf[subschema #5: Completed]/allOf[subschema #2]/commissions from the response with the 200 status
  response-optional-property-removed
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
May 8, 20261b3109ffb8ce1See the full diff
- ●
  added the new payment_cvc_expired enum value to the anyOf[subschema #6: Failed]/allOf[subschema #2]/failureReason/code response property for the response status 200
  response-property-enum-value-added
May 7, 2026805117262a291See the full diff
- ○
  added the optional property anyOf[subschema #5: Completed]/allOf[subschema #2]/commissions to the response with the 200 status
  response-optional-property-added
May 7, 20267377af92f84a1See the full diff
- ○
  removed the payment_cvc_expired enum value from the anyOf[subschema #6: Failed]/allOf[subschema #2]/failureReason/code response property for the response status 200
  response-property-enum-value-removed
May 6, 202636102c3358221See the full diff
- ●
  added the new payment_cvc_expired enum value to the anyOf[subschema #6: Failed]/allOf[subschema #2]/failureReason/code response property for the response status 200
  response-property-enum-value-added

Full history