Skip to main content
This guide walks you through a first purchase flow for a customer buying their first subscription.
You’ll fetch the product catalogue, create an order, calculate price (incl. taxes), collect a prepaid payment, and submit the order for provisioning.

​
Quick Path

Get Product Catalogue

Fetch offers and plans available for the customer’s market.

Create Order

Start an order with customer, subscriber, and offering details.

Calculate Order Price

Calculate taxes and total due (jurisdiction-level for US).

Create Payment Session

Collect prepaid payment before fulfillment.

Submit Order

Lock in the paid order for provisioning.

​
1. Get Product Catalogue

Use this endpoint to present available offers (plans, add-ons) to the user based on their market and brand.
You’ll extract a product_offering_id and other relevant attributes for use when creating an order. 
# 1) Get Product Catalogue - Request
example

```yaml
# 1) Get Product Catalogue - Response
example
  offset: 0
Ref: Get Product Catalog API

​
2. Create Order

Create a draft order by providing the customer, subscriber, and the selected product offering.
At this stage, the order is not yet priced or confirmed. 
# 2) Create Order - Request
example

# 2) Create Order - Response
example
Ref: Create Order API

​
3. Calculate Order Price

Calculate totals for the order, including applicable taxes and fees.
For US-based purchases, pricing is calculated at the jurisdiction level using the billing or service address. 
# 3) Calculate Order Price - Request
example

# 3) Calculate Order Price - Response
example
Ref: Calculate Order Price API

​
4. Create Payment Session (Prepaid)

Generate a payment session for the calculated amount.
This session is used to collect prepaid funds before provisioning the order.
The response includes identifiers for your payment service provider (PSP) that should be used in your client or hosted checkout. 
# 4) Create Payment Session - Request
example
Ref: Create Payment Session API

​
5. Submit Order (Provision)

Once payment has been successfully collected, submit the order to lock in pricing and trigger provisioning 
# 5) Submit Order - Request
example

# 5) Submit Order - Response
example
Ref: Submit Order API That’s it!

​
Next Steps

Order fulfilment

Next step, check the order fulfilment page