The billing state presents the financial billing condition of the Subscription.This data member defines the current billing condition of the subscription, and in combination with the status field, provides a definitive representation of the current condition of a Subscription.The billing state field is read only.
Good Standing:Billing for the current billing period was successful
Free/Trial:The subscriptions current Billing Period definition (as specified by the current Billing Plan) is forcibly free.This can be a temporary state or for the duration of the billing period configured to be free-or permanent if the Billing Plan is permanently free.無料条件がキャンペーン アプリケーションにより送られている場合は、この状態は適用されません。
In Retry: The Subscription is still active but in retry, and has at least one billing period in which there was a failed attempt to charge; the Subscription is still within the configured retry period and may yet be saved by automated processes or customer action.この状態は、前のソフト エラー ステータスに対応しています。新しいスキームでは、アクティブなステータスとのみ組み合わせられます。
Unusable Payment Method:The Subscription is still active but is in retry, and has at least one billing period in which there was a failed attempt to charge, and received an error code designated as a Hard Fail, which is expected to be unrecoverable.The Subscription will remain in this state, in the expectation that a new payment method will be provided by the customer, until the specified retry, or grace period, expires.This state corresponds to the previous Hard Error status when the Subscripiton end date has not passed
Billing Completed: The Subscription is not active; it successfully completed all required billing and has no further scheduled billings.
Failed to Collect: The Subscription is no longer active, having exhausted the retry period without a successful payment method update.This state corresponds to the previous Hard Error status, in which the Subscription end date has passed.This state will only exist for an Subscription with the status:Canceled.
Overdue: The Subscription is assigned a Merchant Accepted Payment (MAP) payment method (invoicing) and has at least one overdue invoice.
Pending Acceptance: The Subscription uses a payment method that requires merchant or customer action before charges can be processed, and is waiting on that external action or approval.
Free Period: The Subscription is currently in a free or $0 billing period for any period excepting a Free=True condition on the initial billing period only, (which uses the Free/Trial state).
Terminated: The Subscription has been forced into a terminal state by system or merchant action.これ以上の請求は計画されていません。
Grace Period: The Subscriptoin has an unpaid balance and is in the retry period but has passed the last scheduled retry attempt-the only path to recovery is a successful payment method update (usually customer intervention).The Subscription is still active and entitled until the end of the Grace Period.