Skip to main content
POST
/
api
/
v1
/
checkout-intents
/
purchase
Error
A valid request URL is required to generate request examples
{
  "buyer": {
    "postalCode": "10001",
    "country": "US",
    "province": "NY",
    "city": "New York",
    "address1": "123 Main St",
    "phone": "1234567890",
    "email": "[email protected]",
    "lastName": "Doe",
    "firstName": "John",
    "address2": "Apt 1"
  },
  "quantity": 123,
  "productUrl": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "state": "retrieving_offer",
  "promoCodes": [
    "<string>"
  ],
  "variantSelections": [
    {
      "value": "Small, Red, XS, L, etc.",
      "label": "Size, Color, etc."
    }
  ]
}

Authorizations

Authorization
string
header
required

Rye API key

Body

application/json

Post body for the purchase endpoint - combines create + confirm in one step. Triggers the durable workflow that handles offer retrieval and order placement.

paymentMethod
object
required
buyer
object
required
quantity
number<integer>
required
Example:

1

productUrl
string
required
variantSelections
object[]

Response

Created

buyer
object
required
quantity
number<double>
required
productUrl
string
required
createdAt
string<date-time>
required
id
string
required
state
enum<string>
required
Available options:
retrieving_offer
promoCodes
string[]
variantSelections
object[]