Skip to main content
Log inSign up
Anchor to SubscriptionBillingAttempt

SubscriptionBillingAttempt

object

Requires read_own_subscription_contracts access scope.

A record of an execution of the subscription billing process. Billing attempts use idempotency keys to avoid duplicate order creation. A successful billing attempt will create an order.

Anchor to Fields and connectionsFields and connections

•

The date and time when the billing attempt was completed.

•
DateTime!non-null

The date and time when the billing attempt was created.

•
ID!non-null

A globally-unique ID.

•
String!non-null

A unique key generated by the client to avoid duplicate payments.

•

The URL where the customer needs to be redirected so they can complete the 3D Secure payment flow.

•

The result of this billing attempt if completed successfully.

•

The date and time used to calculate fulfillment intervals for a billing attempt that successfully completed after the current anchor date. To prevent fulfillment from being pushed to the next anchor date, this field can override the billing attempt date.

•

The reference shared between retried payment attempts.

•

The reference shared between payment attempts with similar payment details.

•

Error information from processing the billing attempt.

•
Boolean!non-null

Whether the billing attempt is still processing.

Anchor to respectInventoryPolicyrespectInventoryPolicy
•
Boolean!non-null

Whether the billing attempt respects the merchant's inventory policy.

Anchor to subscriptionContractsubscriptionContract
•

The subscription contract.

•

The transactions created by the billing attempt.

Show
deprecated fields and connections Deprecated
•

A code corresponding to a payment error during processing. As of API version 2025-01, use processingError.code instead to get the errorCode

•
StringDeprecated

A message describing a payment error during processing. As of API version 2025-01, use processingError.message instead to get the errorMessage


Was this section helpful?

•
query

Returns a SubscriptionBillingAttempt by ID.

•
query

Returns subscription billing attempts on a store.


Was this section helpful?

•
mutation

Creates a new subscription billing attempt. For more information, refer to Create a subscription contract.

•
mutation

Creates a new subscription billing attempt for a specified billing cycle. This is the alternative mutation for subscriptionBillingAttemptCreate. For more information, refer to Create a subscription contract.


Was this section helpful?

•
interface

Was this section helpful?