API & Webview Pricing Policy

API and Webview access are included in selected Aris Product Options subscription plans. There is no separate API-only plan.

Aris Product Options offers API access starting from the Advanced plan.

Plan	API access	Webview access	Webhooks	Included usage	Overage price	Monthly overage cap
Free	No	No	No	_	_	_
Pro	No	No	No	_	_	_
Advanced	Yes (60 req/ min)	No	No	5,000 API calls/billing cycle	$5/5,000-call block	$15
Premium	Yes (60 req/ min)	Yes (600 req/ min)	Yes	25,000 API calls/billing cycle	$10/ 25,000-call block	-

API, Webview, and webhook-related features are only available on supported plans.

Your usage resets at the beginning of each new billing cycle.

One billing cycle is 30 days. Your quota resets by billing cycle, not by calendar month.

Unused calls do not roll over to the next billing cycle.

All subscription and usage charges are processed by Shopify.

Free trial and development stores can use API access for testing and setup, subject to usage limits.

Store type	API Token	Webview Token	Webhooks	Quota	Paid overage
Advanced trial	Yes	No	No	2,000 calls / billing cycle	No
Premium trial	Yes	Yes	Yes	2,000 calls / billing cycle	No
Development store	Testing access if eligible	Testing access if eligible	Testing access if eligible	2,000 calls / billing cycle	No

Free trial and development stores do not have paid API overage.

If the quota is used up, API access may be paused until:

• The quota resets,
• The store upgrades to a paid plan, or
• The store moves to a paid subscription.

Trial and development store usage is intended for testing and setup, not production traffic.

You will not be charged API overage during a free trial or on a development store.

A billing cycle is a 30-day period used to calculate your included API quota, overage usage, and quota reset.

Your quota does not reset by calendar month.

At the beginning of each new billing cycle, your included quota resets based on your current plan.

Unused included calls do not roll over to the next billing cycle.

Overage blocks also do not roll over to the next billing cycle.

3.1. For users with an active subscription when API becomes public

If you already have an active subscription when the API feature becomes publicly available, including Pro, Basic, Advanced, or Premium, your API billing cycle is based on your existing subscription start date.

Example:

If your active subscription started on June 5, your API billing cycle runs from: June 5 to July 4

Your next cycle starts on: July 5

This cycle will continue to follow the same 30-day rhythm.

Changing from one plan to another does not change this API billing cycle when you are using the one-time charge mechanism.

Example:

If your subscription cycle runs from June 5 to July 4, and you upgrade from Advanced to Premium on June 20, your API cycle still remains: June 5 to July 4

It does not restart on June 20.

3.2. One-time charge cycle

Existing users with an active subscription at the time API becomes public will automatically use the one-time charge mechanism for API overage.

Under the one-time charge mechanism:

• Your API cycle is based on your existing subscription start date.
• One billing cycle equals 30 days.
• Your cycle runs from day A to day A + 29.
• Changing plan does not change the cycle.
• One-time usage blocks only apply to the current cycle.
• Extra blocks do not roll over to the next cycle.

Example:

If your subscription started on May 10:

Cycle	Date range
Cycle 1	May 10 – June 8
Cycle 2	June 9 – July 8
Cycle 3	July 9 – August 7

If you buy an extra usage block during Cycle 1, that block is only valid until June 8.

3.3. Usage charge cycle

If you switch from one-time charge to automatic usage charge, your cycle will follow Shopify’s billing cycle.

This means your API quota, overage calculation, and spending cap will follow the Shopify billing cycle connected to your approved usage-based subscription.

Overage applies when your API usage exceeds the included quota in your billing cycle.

Aris supports two billing methods for API overage:

1. One-time charge
2. Usage charge

Your overage experience depends on which billing method your store is using.

4.1. Overage blocks by plan

Plan	Included quota	Overage block	Overage price
Advanced	5,000 calls / billing cycle	5,000 calls	$5 / block
Premium	25,000 calls / billing cycle	25,000 calls	$10 / block

If your usage enters a new overage block, the full block charge applies.

Example:

If you are on Premium and use 50,001 calls in one billing cycle:

Item	Calculation
Included quota	25,000 calls
Extra usage	25,001 calls
Overage blocks	2 blocks
Overage charge	$20

Why 2 blocks?

Because Premium overage is charged per additional 25,000-call block:

• 25,001–50,000 calls = first extra block
• 50,001–75,000 calls = second extra block

4.2. If you are using one-time charge

Under the one-time charge method, Aris does not automatically charge API overage in the background.

When your included quota is used up, you can manually approve and buy extra usage blocks through Shopify.

How one-time charge works

Item	How it works
Extra usage charge	Manually approved by you
Auto charge	No
Shopify approval	Required for each purchase
Extra block validity	Current billing cycle only
Rollover	No
Billing cycle	Based on your existing subscription start date
Cycle change when switching plans	No
Spending cap	Not applied

Important:

One-time charge users only pay for extra blocks they manually approve.

Aris will not automatically add overage charges without your approval.

---

Advanced plan with one-time charge

If you are on Advanced and use one-time charge:

Item	Details
Included quota	5,000 calls / billing cycle
Extra block	5,000 calls
Price per extra block	$5
Maximum extra blocks	Up to 3 blocks
Maximum extra charge	$15 / billing cycle

After 3 extra blocks are used, API access may be paused until the next billing cycle or until you upgrade to Premium.

Advanced one-time charge example:

Usage	Charge
0–5,000 calls	Included
5,001–10,000 calls	Buy 1 block: $5
10,001–15,000 calls	Buy 2 blocks: $10 total
15,001–20,000 calls	Buy 3 blocks: $15 total
Above 20,000 calls	API access may be paused or upgrade may be required

---

Premium plan with one-time charge

If you are on Premium and use one-time charge:

Item	Details
Included quota	25,000 calls / billing cycle
Extra block	25,000 calls
Price per extra block	$10
Spending cap	No fixed spending cap
Extra block approval	Manually approved by you

Premium users using one-time charge can buy as many extra blocks as needed.

Premium one-time charge example:

Usage	Charge
0–25,000 calls	Included
25,001–50,000 calls	Buy 1 block: $10
50,001–75,000 calls	Buy 2 blocks: $20 total
75,001–100,000 calls	Buy 3 blocks: $30 total
100,001–125,000 calls	Buy 4 blocks: $40 total
125,001–150,000 calls	Buy 5 blocks: $50 total
Above 150,000 calls	You can continue buying more blocks if needed

4.3. If you are using usage charge

You may be using the usage charge method if your subscription includes Shopify usage-based billing, or if you switch from one-time charge to automatic usage billing.

Under the usage charge method, API overage can be charged automatically when your usage exceeds the included quota.

You do not need to approve each overage block manually, as long as the charge is within the spending cap you approved in Shopify.

How usage charge works

Item	How it works
Extra usage charge	Automatically charged when usage exceeds quota
Auto charge	Yes
Shopify approval	Required when enabling usage charge or increasing cap
Extra block validity	Current billing cycle only
Rollover	No
Billing cycle	Follows Shopify billing cycle
Spending cap	Required by Shopify

Important:

Usage charge is designed to avoid service interruption. Once approved, extra blocks can be charged automatically within your approved spending cap.

---

Advanced plan with usage charge

If you are on Advanced and use usage charge:

Item	Details
Included quota	5,000 calls / billing cycle
Extra block	5,000 calls
Price per extra block	$5
Spending cap	$15 / billing cycle
Can increase cap?	No

Advanced usage charge example:

Usage	Charge
0–5,000 calls	Included
5,001–10,000 calls	+$5
10,001–15,000 calls	+$10 total
15,001–20,000 calls	+$15 total
Above 20,000 calls	API access may be paused or upgrade may be required

After the $15 spending cap is reached, API access may be paused until the next billing cycle or until you upgrade to Premium.

---

Premium plan with usage charge

If you are on Premium and use usage charge:

Item	Details
Included quota	25,000 calls / billing cycle
Extra block	25,000 calls
Price per extra block	$10
Spending cap	$50 / billing cycle
Can increase cap?	Yes

Premium has a default spending cap because Shopify requires a specific spending limit for usage-based billing.

The spending cap start from $50 / billing cycle, which equals up to 5 extra blocks.

Premium usage charge example with the default $50 cap:

Usage	Charge
0–25,000 calls	Included
25,001–50,000 calls	+$10
50,001–75,000 calls	+$20 total
75,001–100,000 calls	+$30 total
100,001–125,000 calls	+$40 total
125,001–150,000 calls	+$50 total
Above 150,000 calls	API or Webview access may be paused unless the cap is increased

Premium users can increase the spending cap if they need higher API or Webview usage.

If the spending cap is increased, automatic overage can continue within the newly approved cap.

4.4. Quick comparison

Topic	One-time charge	Usage charge
How extra usage is charged	Merchant manually buys extra blocks	Extra blocks are charged automatically
Does merchant approve each block?	Yes	No, if within approved spending cap
Spending cap required?	No	Yes, required by Shopify
Premium default $50 cap applies?	No	Yes
Can Premium exceed $50 usage?	Yes, by buying more blocks manually	Yes, by increasing spending cap
Billing cycle	Based on existing subscription start date	Follows Shopify billing cycle
Does changing plan reset cycle?	No	Follows Shopify billing behavior
Do blocks roll over?	No	No

An API call is counted each time your system sends a request to Aris Product Options API endpoints, such as:

Endpoint	Description
GET /option-sets	Retrieve option sets and related option data
GET /option-sets/:id	Retrieve one specific option set
GET /settings	Retrieve widget settings, CSS settings, or feature settings
GET /localizations	Retrieve translated UI strings

Each successful API request counts as 1 API call.

If your plan includes both API Token and Webview Token access, both token types share the same usage quota.

Aris Product Options supports two token types.

API Token

The API Token is designed for server-side integrations.

You can use it for:

• ERP sync
• OMS sync
• 3PL sync
• Mobile app backend
• Headless storefront backend
• Reporting
• Automation
• Internal tools

Rate limit: 60 requests per minute

Important: The API Token is a secret key and must not be exposed in the browser or frontend code.

Webview Token

The Webview Token is designed for client-side usage, where options need to be displayed outside the standard Shopify storefront.

You can use it for:

• Custom landing pages
• WordPress pages
• Custom storefront pages
• External websites
• Embedded product option widgets outside Shopify theme pages

Rate limit: 600 requests per minute

Important: The Webview Token is public-facing but protected by domain whitelist validation. You must add approved domains before using Webview access.

Webhooks are available only on the Premium plan.

Webhooks allow your system to receive real-time updates when Aris Product Options data changes, instead of repeatedly polling the API.

Available webhook topics:

Webhook topic	When it is triggered
option_set.updated	When an option set is saved, updated, or published
option_set.deleted	When an option set is deleted
settings.updated	When app settings, widget settings, or custom CSS are updated

Webhook deliveries do not count toward your API quota in the billing cycle.

However, if your system receives a webhook and then calls the API to fetch updated data, that API request does count toward your quota.

Example:

1. Aris sends your system an option_set.updated webhook.
2. Your system calls GET /option-sets/:id to fetch the latest data.
3. The webhook delivery does not count toward quota.
4. The API request counts as 1 API call.

If webhook delivery repeatedly fails, Aris may pause or stop webhook delivery to protect system stability. Aris will send a notification when webhook delivery fails, is paused, or is stopped.

Aris Product Options billing is handled by Shopify.

Your subscription fee and any applicable usage charges are processed by Shopify and appear on your Shopify invoice.

Depending on your subscription state, the billing flow may work differently.

8.1. Buy a one-time usage block

This allows you to add extra quota without changing your current subscription.

Action	Result
Buy one-time usage block	Extra quota is added for the current billing cycle
Current subscription	No subscription change
Billing approval	Approved once through Shopify
Rollover	No rollover to next cycle

One-time usage blocks only apply to the current billing cycle.

8.2. Enable automatic overage billing

If you want automatic overage billing, Shopify will require you to approve a new subscription that includes usage-based billing.

When this happens:

• Your current subscription will be cancelled immediately.
• A new subscription will start immediately.
• A new billing cycle will begin.
• Shopify will issue app credit for unused time from your previous subscription according to Shopify’s billing rules.

Aris will always show a confirmation message before redirecting you to Shopify approval.

You can review the billing change before approving it in Shopify.

After you approve the subscription in Shopify, API overage can be applied automatically when your usage exceeds the included quota.

You do not need to approve each overage block manually, as long as your usage remains within your approved spending cap.

If you increase your Premium spending cap, Shopify may ask you to approve the updated billing terms.

API access may be paused, blocked, or rejected in the following cases:

Situation	Result
Trial store exceeds trial quota	API access may be paused
Development store exceeds development quota	API access may be paused
Advanced user reaches the $15 spending cap	API access may be paused until reset or upgrade
Premium user reaches the current spending cap	API or Webview access may be paused unless the cap is increased
Invalid token is used	API request is rejected
Webview domain is not whitelisted	Webview request is rejected
Rate limit is exceeded	Requests may be temporarily rejected
Webhook delivery repeatedly fails	Webhook delivery may be paused or stopped

Aris will send usage and service notifications when important usage events happen.

These alerts are designed to help you monitor usage, avoid unexpected charges, and prevent service interruptions.

Event	What it means
80% quota reached	Your usage is getting close to your included quota
90% quota reached	Your usage is very close to your included quota
100% quota reached	Your included quota has been fully used
Extra block triggered	An additional usage block has been added or charged
Spending cap reached	Your configured spending cap has been reached
API calls are rejected	Requests may be failing due to quota, rate limit, invalid token, access issue, or spending cap
Webhook delivery fails	Aris could not deliver webhook events successfully
Webhook is paused or stopped	Webhook delivery may be disabled due to repeated failures

Aris may notify you by in-app message, email, or other available communication channels.

Merchants are responsible for monitoring their own API usage and integration behavior.