Options
All
  • Public
  • Public/Protected
  • All
Menu

Class Billing

Hierarchy

Index

Constructors

Methods

Constructors

constructor

Methods

cancelDowngrade

  • cancelDowngrade(): Promise<string>

cancelLastOperation

  • cancelLastOperation(): Promise<string>

  • Cancel the last pending operation if the payment has failed.

    Works for subscription upgrade operations and not for recurring payment errors.

    throws

    If there's no pending payment.

    Returns Promise<string>

    Success message.

checkDiscountCoupon

  • Check if a coupon is valid by its promo code.

    throws

    If the coupon code is not valid or not found.

    throws

    If coupon is specific to a an account.

    throws

    If coupon can only be applied to new subscriptions.

    Parameters

    • Optional code: string

      Customer-facing code for the coupon (promo code).

    Returns Promise<BillingCoupon>

editAllocation

  • Edit the resource allocation for the profiles in an account.

    The resource allocation array doesn't need to have an object for each of the account's profiles, as long as the sum of the allocated amounts for the services doesn't exceed the account's service limit.

    The resource allocation object for a profile doesn't need to have all the services.

    throws

    If passed an object that is not an allocation array.

    throws

    If the account only has one profile.

    throws

    If one of the profile IDs in the allocation array doesn't exist in the account.

    throws

    If the allocated amount for one of the services exceeds the available amount.

    Parameters

    Returns Promise<string>

    Success message.

editBillingInformation

editPaymentMethod

  • editPaymentMethod(stripeCardToken: string): Promise<string>

  • Edit an account's payment method.

    throws

    If token is invalid or Stripe can't create the payment method with it.

    Parameters

    • stripeCardToken: string

      Token for the new payment method added via Stripe API.

    Returns Promise<string>

    Success or error message.

editSubscription

  • Edit an account's subscription to change plan, services or add-ons.

    Only one of either plan, services, or addons can be in subscription.

    throws

    If the subscription has a pending operation.

    throws

    If updating more than one of plan, services and add-ons at the same time.

    throws

    If purchasing add-ons or changing service limits on the Free plan.

    throws

    If using an invalid coupon.

    Parameters

    Returns Promise<void>

getAllocation

getBillingInformation

getPaymentHistory

  • Get the payment history for an account.

    The route uses pagination and the lastId parameter should be the stripe_id parameter from the last history entry.

    throws

    If lastId is passed and is invalid.

    Parameters

    • Optional queryObj: { amount?: number; lastId?: string }

      Object to configure the amount of entries fetched and the ID of the history entry for pagination.

      • Optional amount?: number
      • Optional lastId?: string

    Returns Promise<BillingPaymentHistoryEntry[]>

    Array with payment history entries or an empty array when no entries are available.

getPaymentMethod

getPrices

getProratedPrices

getSubscription

getSubscriptionSchedule

  • Get information for the account subscription schedule for downgrades.

    In the response, subscription reflects how the entire subscription will look at the end of the billing cycle when the downgrade is applied. If there is a scheduled downgrade for either plan, services or add-ons, everything is returned and not only the changes.

    Returns Promise<BillingSchedule>

getSubscriptionSummary

removePaymentMethod

  • removePaymentMethod(): Promise<string>

  • Remove an account's payment method from the Stripe subscription.

    Only removes the card if the account is on the Free plan or if it has enough credit balance.

    throws

    If subscription is active with an upcoming invoice.

    throws

    If account doesn't have a payment method.

    Returns Promise<string>

    Success or error message.

retryLastPayment

  • retryLastPayment(): Promise<string>

  • Retry payment for an operation where the payment was unsuccessful.

    Works for payment errors in recurring payments or in subscription upgrade operations.

    throws

    If account has no subscription.

    throws

    If there's no pending payment.

    throws

    If payment method is declined or for other payment processing errors.

    Returns Promise<string>

    Success message.