Guides

Managing Usage

Managing your usage quotas is essential for maintaining smooth operations within Deducto. This guide explains how to monitor and manage both account-level and project-level quotas to ensure you stay within your plan limits.

Understanding quota types

Deducto has two main types of quotas:

Account-level quotas

These quotas apply to your entire Deducto account:

  • Number of Projects: The maximum number of projects you can create under your account
  • User Seats: Maximum number of users you can invite to your account
  • API Requests: Monthly limit of API calls to the Deducto service

While the number of projects and user seats are fixed based on your plan, the API requests are variable and depend on your usage. Your plan comes with a certain number of API requests per month, and you can view your usage and remaining quota in the Usage tab of the Account section. If you use more than your quota, you'll be charged at a specific rate per API request, which is specified in your plan.

Most of your API requests would have been made to the Verify Endpoint, which is used to check applicable promotions for a user's shopping cart.

Project-level quotas

These quotas apply to individual projects:

  • Promotions: Maximum number of promotions per project
  • Coupons: Maximum number of coupon codes across all promotions in a project

The number of promotions and coupons you can create is fixed based on your plan. When you create a promotion, it counts towards your promotion quota for that project. When you create or import coupons, they also count towards your coupon quota for that project. While disabling a promotion does not free up quota, deleting a promotion reduces both your promotion and coupon quota.

What happens when you exceed your API quota

The behaviour depends on how your account is billed.

Direct-billed accounts (billed through Deducto): there is no hard cutoff. Verify, Verify Expected, Record, and Unrecord requests continue to succeed. Each request above your included allowance is recorded as an overage and charged at the per-request rate for your plan. The overage appears on your next invoice. This is by design: silently dropping requests in a live checkout would cause more damage than a larger bill.

Shopify-billed projects: once the project has reached its Shopify usage cap, further API requests are rejected with HTTP 403. The cap resets at the start of your next billing period. You can raise the cap from Shopify Admin (Lite and Pro only) or upgrade to a higher plan tier.

See the FAQs for the full details and options.

Monitoring your usage

Viewing account-level usage

  1. Navigate to the Usage tab in the main sidebar, under the Account section
  2. Here you'll see your current usage metrics including:
    • Total projects created vs. your plan limit
    • User seats filled vs. total available
    • API requests used this month vs. your monthly allowance

Viewing project-level usage

  1. Select a project from the Project List page, after which you will be able to see the project-level sidebar menu
  2. Navigate to the Quotas tab in the sidebar
  3. Review the usage section showing:
    • Active promotions count vs. your plan limit
    • Coupon codes used vs. your plan limit

Managing your quotas

Freeing up promotion quota

Both Enabled and Disabled promotions count toward your project's promotion quota. To free up quota, you can choose to delete a promotion and all data associated with it. This will free up the quota for that project once the deletion is completed.

Having fewer number of active promotions will also reduce the number of promotions Deducto has to check every time a user's cart has changed, slightly improving the response time of those API requests.

⚠️

Warning

Deleting a promotion permanently removes all associated data from the database, including usage data and coupon codes. This action cannot be undone, so be sure to export usage data or coupon codes before deleting if you need to keep track of them.

To delete a promotion:

  1. Navigate to the Promotion List Page
  2. Click on the name of the promotion you want to delete
  3. Navigate to the Danger Zone tab
  4. Click on the Delete Promotion button

This will make a request to the Deducto API to delete the promotion and start the deletion process. Once the deletion is completed, both your promotion and coupon quotas related to this promotion will be freed up for that project.

Managing coupon quota

To free up coupon quota:

  1. Navigate to the promotion containing the coupons
  2. Navigate to the Coupons tab
  3. Either delete individual coupons or delete all unused coupons by clicking the Delete Unused button

This will start a process to delete all coupons associated with this promotion that have never been used and free up the coupons quota for that project.

Upgrading your plan

If you consistently reach your quota limits, consider upgrading your subscription plan by getting in touch with our support team.

Best practices

  • Regularly review inactive promotions and consider deleting those that are no longer needed
  • Delete seasonal promotions and recreate them later if needed
  • Monitor your API usage throughout the month to avoid unexpected overage charges
  • Delete test promotions and coupons once testing is complete to free up quota
  • Consider upgrading your plan if you are consistently reaching your quota limits, but be sure to leave ample time so that the upgrade can be processed

By actively managing your quotas, you can ensure your promotional activities run smoothly while optimising your subscription costs.

Updated 9 days ago