Skip to navigation

BillingPlans Resource

View as Markdown

The Billing resource provides methods that allow you to manage the billing plans associated with an account.

Methods supported

MethodDescription
getGET /restapi/v2.1/billing_plans/{billingPlanId}
Gets billing plan details.
getAccountPlanGET /restapi/v2.1/accounts/{accountId}/billing_plan
Get Account Billing Plan
getCreditCardGET /restapi/v2.1/accounts/{accountId}/billing_plan/credit_card
Get credit card information
getDowngradeRequestBillingInfoGET /restapi/v2.1/accounts/{accountId}/billing_plan/downgrade
Returns downgrade plan information for the specified account.
listGET /restapi/v2.1/billing_plans
Gets a list of available billing plans.
purchaseEnvelopesPUT /restapi/v2.1/accounts/{accountId}/billing_plan/purchased_envelopes
Reserved: Purchase additional envelopes.
updatePUT /restapi/v2.1/accounts/{accountId}/billing_plan
Updates an account billing plan.
updateDowngradeAccountBillingPlanPUT /restapi/v2.1/accounts/{accountId}/billing_plan/downgrade
Queues downgrade billing plan request for an account.

BillingPlans properties

PropertyTypeDescription
billingAddressaccountAddressThe billing address for the account.
billingAddressIsCreditCardAddressstringWhen true, the credit card address information is the same as that returned as the billing address. If false, then the billing address is considered a billing contact address, and the credit card address can be different.
billingPlanaccountBillingPlanAn object that contains details about the billing plan.
creditCardInformationcreditCardInformationA complex type that has information about the credit card used to pay for this account.
directDebitProcessorInformationdirectDebitProcessorInformationInformation about the bank that processes direct debits for the payment plan.
downgradePlanInformationdowngradePlanUpdateResponse
downgradeRequestInformationdowngradeRequestInformation
entityInformationbillingEntityInformationResponse
paymentMethodstringThe payment method used for the billing plan. Valid values are:
  • NotSupported
  • CreditCard
  • PurchaseOrder
  • Premium
  • Freemium
  • FreeTrial
  • AppStore
  • DigitalExternal
  • DirectDebit
paymentProcessorInformationpaymentProcessorInformationInformation about the entity that processes payments for the billing plan.
referralInformationreferralInformationContains information describing discounts and promotions.
successorPlansarrayA list of billing plans that the current billing plan can be rolled into.
taxExemptIdstring