Zid Docs
Apps
ThemesPayments
Apps
ThemesPayments
Help Center
Telegram Community
  1. Plans & billing
  • πŸ—‚οΈ Overview
  • πŸš€ Start Here
  • Responses
  • Rate Limiting
  • Embedded Apps
  • StoreFront Events
  • Zid MUI
  • Zid SDKs
  • Our custom MCP server
  • Zid AI Agent Skill
  • Build an app
    • Create your First App
    • Justifying your scopes
    • Test your app before you submit
    • Submitting your app for review
    • Plans & billing
      • Plans and pricing
      • Creating a plan
      • Usage-based plans
      • Private plans
      • Subscription and app events
      • Changing a plan
  • Authorization
    • Authorization
    • Public Apps OAuth Requirements
    • OAuth Errors & Troubleshooting
    • Zid Bridge Tool
  • Merchant APIs
    • Account
      • Me
        • Me
      • Store
        • Store
        • Branding
        • Localization
        • Social
        • Operations
        • Business
        • Upload Logo Image
        • Delete Logo Image
        • Upload Icon Image
        • Delete Icon Image
        • Upload Cover Image
        • Delete Cover Image
    • Orders
      • Order Tags
        • List Order Tags
        • Create Order Tag
      • Validate Order Request
      • Create Order
      • Change Order Status
      • Add Order Comment
      • View Order
      • List Orders
      • List Custom Order Statuses
      • List Order Credit Notes
      • Get Orders Highlights
      • Order Fulfillment Inventories
      • Bulk Create/Update Custom Order Statuses
    • Reverse Orders
      • Create Reverse Orders
      • Create Reverse Orders Waybill
      • Add Reverse Order Reasons
      • List Reverse Reasons
      • Calculate Reverse Totals
      • Create refund for reverse order
      • Upload bank transfer receipt
      • Update return products
      • Order Details – View for Return
    • Abandoned Carts
      • List Carts
      • View Cart
      • Validate Abandoned Cart Messages
      • Send Abandoned Cart Notification Manually
    • Products
      • Managing Products
        • Create Product Types
        • Create Product
        • List Products
        • View Product
        • List Product Settings
        • Update Product
        • Bulk Update Products
        • Delete Product
      • Digital Vouchers
        • List Vouchers
        • Order Vouchers
        • Create Voucher
        • Import Vouchers
        • Export Vouchers
        • Update Voucher
        • Remove Voucher
      • Product Categories
        • List Categories
        • View Category
        • Create Category
        • Create Subcategory
        • Update Category
        • Assign Product to Category
        • Bulk Assign Products to Category
        • Publish Category
        • Detach Category from All Products
        • Remove Product from Category
        • Set Categories Nesting
        • Delete Category Cover Image
        • Upload Category Cover Image
        • Delete Category
        • Delete Category Image
        • Upload Category Image
        • Update Category
      • Product Brands
        • List Brands
        • Single Brand
      • Product Badge
        • List Badges
      • Product Attributes
        • List Attributes
        • View Attribute
        • Create Attribute
        • Update Attribute
        • Delete Attribute
      • Product Attribute Presets
        • List Presets
        • Create Preset
        • Update Preset
        • Delete Preset
      • Product Variants
        • Create Variants
        • Create Custom Option
        • Update Custom Option
        • Delete Custom Option Field
        • Create Custom Input Field
        • Update Custom Input Field
        • Delete Custom Input Field
      • Product Sorting
        • Set Manual Product Order
        • Reset Manual Product Order
      • Product Images
        • List Images
        • Upload Image
        • Update Image Order
        • Delete Image
      • Product Availability Notifications
        • Notification Stats
        • Noticiation Settings
        • List Notifications
        • Create Notification
        • Update Settings
        • Send Notification Email
        • Export Notifications
      • Product Export
        • Email All Products to Store Owner
        • Import Products via CSV or xlsx File
      • Product Stock
        • Retrieve Product Stock
        • List Product Stock Records
        • Create Product Stock
        • Update Product Stock
        • Bulk Update Product Stock Records
      • Product Questions & Answers
        • Retrieve Product Question
        • Retrieve Product Answer
        • List Product Questions
        • List Answers for Question
        • Create Product Question
        • Create Product Answer
        • Update Product Question
        • Update Product Answer
        • Delete Product Question
        • Delete Product Answer
        • List Store Product Questions
      • Product Reviews
        • List Reviews
        • Count Reviews
      • Digital Products
        • Create Downloadable Product
        • Generate Upload URL
        • Upload File to S3
        • Create Product Downloadable
        • Get Product Downloadables
        • Delete Product Downloadable
        • List Store Downloadables
        • Create Store Downloadable
        • Delete Store Downloadable
    • Inventories
      • Create Location
      • Update Location
      • Update Product Stock for Location
      • List Locations
      • View Location
    • Shipping
      • List Store Shipping Methods
    • Marketing
      • Coupons
        • List Coupons
        • View Coupon
        • Create Coupon
        • Generate Bulk Coupons
        • Duplicate Coupon
        • Duplicate Bulk Coupons
        • Update Coupon Note
        • Update Coupon
        • Update Bulk Coupons
        • Update Coupon Status
        • Update Bulk Coupons Status
        • Delete Coupon
        • Delete Bulk Coupons
      • Bundle Offers
        • List Bundle Offers
        • View Bundle Offer
        • Create Bundle Offer
        • Update Bundle Offer
        • Delete Bundle Offer
        • Bulk Delete Bundle Offers
      • Loyalty Program
        • Loyalty Program Status
        • Loyalty Program Details
        • Loyalty Program Info
        • Customer Loyalty Summary
        • Customer Points History
        • Activate Loyalty Program
        • Set Points Expiration Rules
        • Update Cashback Rule
        • Create Points Redemption Method
        • Update Points Redemption Method
        • Delete Points Redemption Method
        • Adjust Customer Points
        • Update Redemption Method Status
        • Loyalty Program Analytics
        • Loyalty Program Settings
      • Customer Wallets
        • Cashback Rules
          • List Cashback Rules
          • Create Cashback Rule
          • Retrieve Cashback Rule
          • Update Cashback Rule
          • Delete Cashback Rule
        • Wallet Analytics
          • Get Wallet Analytics
          • Get Wallet Analytics by Rule
        • Manager Customer Wallet
          • List Customer Wallets
          • Bulk Credit Customer Wallets
          • Bulk Debit Customer Wallets
          • Export Customer Wallets
          • Get Customer Wallet Balance
          • Credit Customer Wallet
          • Debit Customer Wallet
          • Customer Pending Cashbacks
          • Customer Wallet Transactions
    • Customers
      • Customer Tags
        • List Customer Tags
        • Add Customer Tag
        • Ω’Update Customer Tag
        • Delete Customer Tag
      • Customer Portal Tickets
        • List Customer Portal Tickets
        • Customer Portal Ticket Detail
      • List Customers
      • View Customer
      • Primary Customer List
      • FInd Customer By Phone Number
      • Customer Profile
      • Add Customer
      • Update Customer
      • Delete Customer
      • Add Bulk Customers
      • Import Customers
    • Store Settings
      • πŸ“„ User Roles and Permissions
      • Retrieve Store Manager Profile
      • Retrieve VAT Settings
      • List Payment Methods
      • List Store Operating Countries
      • OneSignal Store Settings
      • Create or Update OneSignal Store Settings
      • Get Payment Options
    • Countries and Cities
      • List Countries
      • List Cities for Country
    • Blogs
      • Settings
        • Create
        • List
      • Categories
        • Create
        • List
        • Bulk Activate
        • Bulk Deactivate
        • Bulk Delete
        • Retrieve
        • Destroy
        • Partial Update
        • Bulk Add To Posts
        • Bulk Remove From Posts
        • Bulk Delete Blog Categories
      • Posts
        • Media
          • List
          • Create
          • Destroy
        • Create
        • List
        • Retrieve
        • Partial Update
        • Destroy
        • Archive
        • Publish
        • Bulk Archive
        • Bulk Publish
        • Bulk Delete
        • Export Posts
        • Import Template
        • Import Posts
      • Tags
        • Create
        • List
        • Retrieve
        • Partial Update
        • Destroy
        • Bulk Delete Tags
        • Bulk Add To Posts
        • Bulk Remove From Posts
      • Storefront
        • Posts
          • List
          • Retrieve
        • Categories
          • List
          • Retrieve
        • Tags
          • List
  • Webhooks
    • Overview
    • Webhook Health Tracking
    • Events
      • Order
      • Product
      • Abandoned Cart
      • Customer
      • Product Category
    • APIs
      • Health Summary
      • Broken Webhooks
      • Recover Broken Webhooks
      • List Webhooks
      • Create Webhook
      • Delete Webhook
      • Delete Webhook By subscriber
  • App Management
    • Events
    • APIs
      • Update Usage-Based Charges
      • Subscription Details
      • Add-on Purchases
  1. Plans & billing

Plans and pricing

Every app on Zid App Market is sold through plans. A plan sets what a merchant pays, how long it lasts, and what they get.
This page applies to OAuth apps published in Zid App Market.
Private apps are not sold through the market and cannot have plans. Shipping apps are priced differently β€” see their own guide.

Before you submit your app for review#

Zid's review team needs a way to test your app. Before you submit, your app must have one of these:
a free plan, or
a paid plan with a free trial.
Free trials work the same way during review and after your app goes live, so you don't need to change anything once your app is approved.
Apps are not published as permanently free. A free plan exists so your app can be reviewed and tested β€” not as a way to offer your app at no cost.

Plan types#

TypeWhat the merchant paysHow long it lastsUse it for
FreeNothingRenews automatically, so it does not expireLetting Zid review and test your app
RecurringA fixed price each period1 to 11 months, or 1 yearMost apps
Usage-basedA one-time starting price, then charges you add based on what they useOpen-ended β€” no end date, and it never renewsApps where the cost depends on consumption, such as messages sent or orders processed
You can also create a private plan β€” a custom plan for one specific merchant. See Private plans.

App Add-ons#

App add-ons let you sell additional features or services separately from your application's subscription plans, such as extra message credits or a one-time setup service.
Add-ons are available in two billing types:
TypeDescription
One-timeA single prepaid purchase for additional features or services.
MonthlyA recurring purchase that renews monthly until cancelled.
You can offer add-ons as:
Public add-ons: Available to merchants who have installed your app, after Zid's approval.
Targeted add-ons: Offered to a specific merchant using their Store ID, without requiring Zid's review.
Merchants purchase add-ons through Zid's payment flow without changing their existing application subscription.

Tracking Add-on Purchases#

Use the following integrations to manage add-on fulfillment:
Subscription and App Events: Receive notifications about purchases, renewals, payment failures, cancellations, expirations, and refunds.
Add-on Purchases API: Retrieve a merchant's purchased add-ons, payment history, and current purchase status.
Note: Add-ons are separate from subscription plans and do not change the rules governing recurring and usage-based plan types.

Two rules to know before you start#

1. All of your app's plans must be the same type.
An app can have recurring plans or usage-based plans β€” not both. To switch from one to the other, you must remove the existing plans first.
2. A merchant holds one subscription per app.
A merchant can be on only one of your plans at a time. They can move between plans, but they cannot hold two at once. Merchants can also purchase separate add-ons without creating another application subscription.

Limits#

Limit
Plans per app8
CurrencySAR only

Common questions#

Can merchants buy a one-time package on top of their subscription?#

Yes. Merchants can purchase one-time add-ons, such as additional message credits or setup services, without changing their existing subscription plan.
You can create public add-ons for all merchants who have installed your app or targeted add-ons for specific merchants.
Monthly add-ons are also available for recurring additional services.
For technical integration, see Subscription and App Events and Add-on Purchases API.

Can I charge a setup fee when a merchant first installs my app?#

Yes. Add an installation fee to a recurring plan. It is charged once per merchant, the first time they subscribe, and never again. See Creating a plan.

Can I offer a free period or a discount?#

Yes, on recurring plans. You can add a free trial of up to 90 days, a discount of up to 60%, or a "subscribe for X, get Y free" offer. See Creating a plan.

Can I change a plan later?#

Yes. Changes you make to your own plans β€” price, features, duration β€” are reviewed by Zid before they take effect.
If you mean a merchant moving from one of your plans to another, that is a different thing and it has its own rules about what happens to the time they already paid for. See Changing a plan.

Can I set prices in another currency?#

No. All plans are priced in SAR.
Modified atΒ 2026-11-10 14:19:13
Previous
Plans & billing
Next
Creating a plan
Built with