Zid Docs
Apps
ThemesPayments
Apps
ThemesPayments
Help Center
Slack
  1. Plans & billing
  • πŸ—‚οΈ Overview
  • πŸš€ Start Here
  • Create your First App
  • Responses
  • Rate Limiting
  • Embedded Apps
  • StoreFront Events
  • Zid MUI
  • Zid SDKs
  • Our custom MCP server
  • Zid AI Agent Skill
  • 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
      • Subscription Details
      • Update Usage-Based Charges
  • Build an app
    • Justifying your scopes
    • Plans & billing
      • Plans and pricing
      • Creating a plan
      • Usage-based plans
      • Private plans
      • Subscription and app events
  1. Plans & billing

Creating a plan

You create and edit plans in the Partner Dashboard, under your app's Plans section.

Before you submit for review#

Check all of these before sending your app to Zid for review:
Your app has a free plan, or a paid plan with a free trial, so the review team can test it
Every plan has a name, description and at least one feature, in both Arabic and English
Your app has no more than 8 plans
All plans are the same type β€” either all recurring, or all usage-based
You have decided how your app will track subscriptions β€” webhook events, the Subscription Details endpoint, or both. See Subscription and app events

Step 1: Choose the plan type#

Pick one of three types. The fields you fill in depend on which you choose.
Free β€” no payment. Use it so Zid can review and test your app.
Recurring β€” a fixed price per period. Use it for most apps.
Usage-based β€” a starting price plus charges based on consumption.
Remember: all of your app's plans must be the same type. A free plan can sit alongside recurring plans, but recurring and usage-based plans cannot be mixed.

Step 2: Fill in the shared fields#

Every plan needs these, in both Arabic and English:
FieldRule
Plan nameUp to 50 characters. The Arabic name must be written in Arabic, the English name in English. Letters, numbers, spaces and . | - ( ) only.
DescriptionBetween 50 and 300 characters.
FeaturesBetween 1 and 5 lines. Each line up to 50 characters.
Each feature is a pair β€” write it in Arabic and English together.

Step 3: Fill in the fields for your plan type#

Free plan#

Nothing more to fill in. A free plan has no price, duration, trial, installation fee or offer. It renews automatically, so it does not expire.

Recurring plan#

FieldRule
PriceAt least 1 SAR, up to 120,000 SAR
DurationChoose from the list: 1 to 11 months, or 1 year
Free trialOptional. Up to 90 days
Installation feeOptional. At least 1 SAR. See below
OfferOptional. See Offers below

Usage-based plan#

FieldRule
PriceAt least 1 SAR. This is what the merchant pays when they subscribe
DurationFixed at 30 days β€” you cannot change it
Usage typeCalls, messages, orders, emails, or Other
Custom usage labelRequired only if you choose Other. Up to 50 characters, in both languages
Usage-based plans do not support free trials, installation fees or offers. A usage-based subscription has no end date β€” it continues until a charge goes unpaid. See Usage-based plans.

Installation fee (one-time fee)#

In the dashboard this field is described as "the additional charges required at the first time of your app installation". It adds a one-off amount on top of the plan price, charged when a merchant first subscribes to your app.
It is charged once per merchant, ever.
Once a merchant has paid your app's installation fee, they will never be charged it again β€” not when they renew, not when they switch plans, and not when they resubscribe later.
Things to know:
Creating a new plan with a new installation fee does not let you charge an existing merchant again.
Deleting a plan and creating it again does not reset the fee.
Merchants who subscribed before you added the fee are never charged it.
If the fee is owed and has not been paid, the subscription does not activate.
Do not use the installation fee to sell packages or repeat purchases. It only works once per merchant.

Offers#

Offers are available on recurring plans only. Choose one of two kinds:
Buy X, get Y free β€” the merchant subscribes for the plan period and gets extra free time. The free period must be a whole number of months, or exactly 1 year, and it cannot be longer than the plan's own duration.
Discount β€” a percentage off the plan price, up to 60%.
Offers cannot be added to free plans or usage-based plans.

Step 4: Submit your changes#

Plan changes are sent to Zid for review before they go live. You can save your work as a draft first and submit when you're ready.

All limits at a glance#

Limit
Plans per app8
Plan name50 characters
Description50 to 300 characters
Features1 to 5 lines, 50 characters each
Price1 to 120,000 SAR
Duration (recurring)1 to 11 months, or 1 year
Duration (usage-based)Fixed at 30 days
Free trialUp to 90 days
Installation feeAt least 1 SAR, charged once per merchant
Discount offerUp to 60%
CurrencySAR only
Modified atΒ 2026-10-21 14:10:32
Previous
Plans and pricing
Next
Usage-based plans
Built with