Skip to main content
13 min readBilling & Invoicing

Credit Handling for Custom Plans

Understand how email, SMS and WhatsApp credits are configured, spent, renewed, adjusted, and displayed so campaign failures make sense before they become support tickets.

Credits are the usage currency attached to a customer custom plan for campaign sending. They are not a separate vendor wallet. They are limits that the agency, acting as the platform owner, defines for each customer.

Most confusion happens when agencies understand providers but do not understand plan limits. A failed invite is usually not a mystery. It usually means the assigned customer plan has run out of the credit type needed for that message.

What credits are

Credits are used for campaign sending, not for general system activity. They apply to review request emails, SMS messages, and their reminders based on the customer custom plan configuration.

Transactional messages such as password resets, review alerts, invitations, and system notifications are separate and do not consume campaign credits.

  • Email credits are used for email review request campaigns
  • SMS credits are used for SMS review request campaigns
  • Transactional email does not consume campaign credits

Where credits are configured

Credits are configured on the `General` tab of a custom plan under the usage limits area. The three fields are `Monthly Email Credits`, `Monthly SMS Credits`, and `Monthly WhatsApp Credits`.

FieldWhat it controls
Monthly Email CreditsHow many email campaign messages the customer can send each month
Monthly SMS CreditsHow many SMS campaign messages the customer can send each month
Monthly WhatsApp CreditsHow many WhatsApp campaign messages the customer can send each month
Worth knowing

For credits, 0 means no credits, not unlimited. That is different from some other usage fields such as max locations or max team members where 0 can mean unlimited.

How email credits work

Email campaign messages are flat-rate from a credit perspective. Each email invite or email reminder costs 1 email credit.

The platform checks the balance at send time. If the balance reaches zero, the remaining email sends fail with a not-enough-credits style failure.

  • Email review request campaigns cost 1 credit per email
  • Email reminders cost 1 additional credit per reminder email
  • Password resets, review alerts, team invitations, and similar transactional email do not consume campaign credits
Worth knowing

If the send resolves to an email provider the customer owns — their own Gmail, Outlook, or any provider they connected themselves — it does not consume their plan email credits.

How SMS credits work

SMS credits are not flat-rate. They are segment-based. Standard 160-character SMS messages use one segment, but longer messages split into multiple segments and each segment costs a credit.

If the content uses UTF-16 characters, the segment length drops, which can make a message more expensive than it looks at first glance.

  • Fancy punctuation and non-standard characters can reduce the segment size
  • The system sanitises some common punctuation styles to avoid unnecessary encoding inflation
  • SMS credit checks happen before each individual message is sent
ExampleCredit cost
140-character standard SMS1 credit
200-character standard SMS2 credits
400-character standard SMS3 credits
MMS with attached imageText segment cost plus 1 extra credit
Worth knowing

If a customer uses their own SMS provider, such as Twilio or Vonage connected on their side, those SMS sends do not consume the agency-side SMS credits.

How credits renew

Credits renew monthly. Old subscription credits expire and a fresh allocation is granted. They do not roll over automatically from month to month.

If Stripe billing is connected, the renewal timing follows the billing cycle timing. If Stripe is not connected, the platform still renews credits on the internal monthly schedule tied to the customer subscription state.

  • Subscription credits expire when the new cycle begins
  • Fresh credits are granted based on the customer's current plan limits
  • Cancelled customers in grace period do not receive a new renewal allocation

What happens when you change credit limits

When you change a specific customer's credit limits from the Manage Customer page, their balance updates immediately — old subscription credits are expired and the new allocation granted right away.

Changing the limits on the plan itself applies to existing subscribers at their next monthly renewal, not instantly.

The no credits during trial option

Under the advanced campaign options area there is a toggle for `No Credits During Trial`. This controls whether trial customers receive campaign credits before they become paying subscribers.

  • Enabled: trial customers get no campaign credits until they become paying customers
  • Disabled: trial customers receive their normal plan credits during trial

Manually adding or removing credits

You can manually adjust credits from the customer manager by opening the credit adjustment flow, choosing Email, SMS or WhatsApp, setting a positive or negative amount, optionally adding an expiry date, and leaving notes.

These manual adjustments are tracked separately from subscription credits so they remain visible in the transaction history.

  • Positive amounts add credits
  • Negative amounts remove credits
  • Manual adjustments can have their own expiry date
  • Old subscription credits can also be expired manually when needed

Credits only work with feature access enabled

Credits alone are not enough. The corresponding campaign channels also need to be enabled on the plan. Otherwise the credits can exist but the feature still stays hidden or unavailable.

FeatureWhere it is configuredWhat it controls
Email CampaignsCampaigns tabWhether the customer can use email campaigns at all
SMS CampaignsCampaigns tabWhether the customer can use SMS campaigns at all
WhatsApp CampaignsCampaigns tabWhether the customer can use WhatsApp campaigns at all
Monthly Email CreditsGeneral tabHow many email campaign messages they can send
Monthly SMS CreditsGeneral tabHow many SMS campaign messages they can send
Monthly WhatsApp CreditsGeneral tabHow many WhatsApp campaign messages they can send
Worth knowing

If Email Campaigns is enabled but email credits are 0, the feature may be visible but sending will still fail. If credits exist but the feature is hidden, the customer cannot use them.

What the agency and customer see

From the agency side, customer balances are visible in the customer manager. From the customer side, `Manage -> Billing -> Credit usage` (and `Buy credits` where offered) shows summary cards and a transaction history by type, credit type, and date.

If the customer's plan sets Billing Pages to Hidden, the customer sees no billing menu and cannot reach these pages at all.

  • Subscription renewals, adjustments, usage, and product purchases appear as separate transaction types
  • Expired entries are visibly flagged
  • Customers can also buy extra credits if credit products are configured
Worth knowing

This is a customer-side screen. Because you are in your agency account, you can reach it two ways: go to `Business -> Customers -> Manage Customers` and click `Open dashboard` on the customer — you go into their dashboard with nothing locked, even features their plan hides, and a bar at the top shows whose dashboard you are in (handy for done-for-you setups or granting access beyond a plan); or choose `View as customer` on the same page to see their dashboard exactly as they see it, with their plan's limits. If your sidebar shows the `Agency` / `Customer` switcher, the `Customer` tab plus the location switcher is a shortcut to the same place.

Credit spending order

Credit pools are consumed oldest-first, and pools past their expiry date are excluded automatically.

Common questions