VoxEngine Development

How billing works

Understand Voximplant billing, charges, and usage-based costs.

View as Markdown

Understanding how Voximplant manages your balance, subscriptions, and automated payments ensures your services remain uninterrupted.

Account balance & top-ups

Your account balance is the central pool for all Voximplant services.

  • Pricing reference: See live rates on our pricing page or in the control panel.
  • Low balance alerts: By default, we email you at $5.00. You can customize this in the notification settings.
  • Negative balance: If a call is active when your balance hits $0, it may continue, resulting in a negative balance. Services resume once topped up.
  • Auto top-up: Link a card via Make a payment and contact Technical support to set your custom threshold and recharge amount.

Instant Messages & Monthly Active Users (MAU)

Voximplant uses a subscription model for messaging and user logins, starting with a Free tier.

| Plan component | Free limit | Exceeding the limit | | Instant Messages (IM) | 50K / month | Messages stop sending. | | Active Users (MAU) | 1,000 / month | New user logins are blocked. |

Paid plans (Small, Medium, Custom)

Unlike the free tier, paid plans allow you to exceed limits. You are charged per pack of 100 additional messages or per new user login.

Critical definitions

IM tracking

The counter triggers on sendMessage, editMessage, and removeMessage. We count all actions regardless of delivery status.

MAU tracking

An active user is defined by a unique credential logging in at least once a month. One user logging in from multiple devices counts as one MAU. Active users of child accounts are billed to the parent account.

Plan changes & management

You can scale your subscription tier directly through the Billing section or via the ChangeAccountPlan Management API method.

  • Upgrading: Can be done manually at any time.
  • Downgrading: Requires a request to Technical support.
  • Prorated refunds: If you change plans mid-cycle, we refund the reserved amount for the old plan (minus usage) and apply the new plan’s rate for the remaining days of the month.

Grace period (USD and EUR accounts)

The grace period is a safety net enabled by default to prevent service interruption if a card payment fails.

  • How it works: If your balance is insufficient for a subscription renewal, we “credit” the fee amount to your account for one month.
  • Repayment: The credit must be repaid by the 1st day of the next month to avoid account suspension.
  • Restrictions: While in a grace period, you can spend remaining cash on calls, but you cannot purchase new plans until the credit is cleared.
API check

Use GetAccountInfo to check your grace_credit status. A positive value indicates an active credit.

Phone Number Subscriptions

Purchasing a phone number involves specific one-time and recurring charges.

| Charge type | Timing | | Setup fee (+ tax) | One-time at purchase. | | Subscription fee (+ tax) | Reserved monthly on the purchase anniversary. |

Important renewal rules

  • Reservation vs. charge: We reserve the fee on your anniversary date, but the final tax-adjusted charge occurs on the 1st of the following month.
  • Insufficient funds: If a reservation fails, the number is suspended for one month. If unpaid after that month, the number is released back into the public pool.
  • Verification: Numbers in some countries are only activated after you pass local verification.
  • Cancellation: Delete numbers via the phone numbers menu in the control panel to stop recurring billing.

Invoices & taxes

Taxes are calculated based on your total spending and registered billing address.

  • Calculation: Final tax rates are determined at the end of each month to account for any address updates or rate changes.
  • Availability: Invoices are generated and sent on the first day of every month.
  • Reports: Access and download all historical invoices in the Billing section of the control panel.

Regional differences

The billing experience varies slightly depending on your account currency:

USD and EUR accounts

  • Address requirement: You cannot add funds to your account without a valid billing address or VAT number.
  • Variable Rates: Tax rates vary significantly based on your specific location and the services consumed.
  • API Management:

RUB accounts

  • Flat rates: Tax rates are uniform for all customers.
  • Immediate deduction: Prices are shown and deducted with tax already included.
  • Invoice detail:
    • Legal entities: Receive invoices with separate line items for price and tax.
    • Individuals: Receive invoices showing the total consolidated amount paid.