API & Webview Pricing Policy
This policy explains how Avis Product Options charges for API and Webview usage. Our goal is to make pricing clear, predictable, and easy to understand before you start using these features.
API and Webview access are included in selected Avis Product Options subscription plans. There is no separate API-only plan.
1. Summary
Avis Product Options offers API access starting from the Advanced plan.
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.
2. Trial and development store usage
Free trial and development stores can use API access for testing and setup, subject to usage limits.
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.
3. Billing cycle and quota reset
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 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.
4. How overage blocks and spending caps work
Overage applies when your API usage exceeds the included quota in your billing cycle.
Avis supports two billing methods for API overage:
One-time charge
Usage charge
Your overage experience depends on which billing method your store is using.
4.1. Overage blocks by plan
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:
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, Avis 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
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.
Avis 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:
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:
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:
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:
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
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:
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:
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:
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:
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
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
5. What counts as an API call?
An API call is counted each time your system sends a request to Avis Product Options API endpoints, such as:
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.
6. API Token vs Webview Token
Avis 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.
7. Webhooks
Webhooks are available only on the Premium plan.
Webhooks allow your system to receive real-time updates when Avis Product Options data changes, instead of repeatedly polling the API.
Available webhook topics:
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:
Avis sends your system an
option_set.updatedwebhook.Your system calls
GET /option-sets/:idto fetch the latest data.The webhook delivery does not count toward quota.
The API request counts as 1 API call.
If webhook delivery repeatedly fails, Avis may pause or stop webhook delivery to protect system stability. Avis will send a notification when webhook delivery fails, is paused, or is stopped.
8. How Shopify billing works
Avis 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.
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.
Avis 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.
9. When API access may be paused or rejected
API access may be paused, blocked, or rejected in the following cases:
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
10. Usage alerts and service notifications
Avis 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.
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
Avis could not deliver webhook events successfully
Webhook is paused or stopped
Webhook delivery may be disabled due to repeated failures
Avis 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.
11. Frequently asked questions
Are API Token and Webview Token usage counted separately?
No. They share the same quota for that billing cycle.
For example, Premium includes 25,000 total calls per billing cycle across both API Token and Webview Token usage.
When does my API quota reset?
Your API quota resets at the beginning of each Shopify app billing cycle.
The billing cycle starts when your paid subscription charge begins, immediately after the 14-day free trial ends.
It does not start when you generate an API token or make your first API call.
Do webhook deliveries count toward quota?
No. Webhook deliveries do not count toward your monthly API quota.
However, API requests made after receiving a webhook do count.
Can I avoid overage charges?
Yes. You can reduce usage by caching API responses, avoiding unnecessary repeated requests, using webhooks instead of polling, or upgrading to a plan with a higher included quota.
What happens if I hit the Advanced spending cap?
Further API usage may be paused until the next billing cycle or until you upgrade to Premium.
What happens if I hit the Premium spending cap?
Further API or Webview usage may be paused until the next billing cycle, unless you increase your spending cap.
Is Premium unlimited?
No. Premium is designed for higher-volume usage, but it is not unlimited by default.
Premium includes 25,000 calls per billing cycle and has a default API overage spending cap of $50 per cycle. You may increase the spending cap if your store needs higher usage.
Will I be charged overage during a free trial?
No. Free trial stores do not have paid API overage.
If the trial quota is used up, API access may be paused until the store upgrades or the quota resets.
Will development stores be charged overage?
No. Development stores are not charged API overage.
If the development quota is used up, API access may be paused until the quota resets or the store moves to a paid subscription.
Why do I need to approve a new subscription to enable automatic overage?
Some existing subscriptions may not include usage-based billing yet.
To enable automatic API overage, Shopify may require you to approve a new subscription that includes both the monthly plan and usage-based billing terms.
Avis will show a confirmation message before redirecting you to Shopify approval.
Last updated