Skip to main content
Log inSign up

Shopify uses cookies to provide necessary site functionality and improve your experience. By using our website, you agree to our privacy policy and our cookie policy.

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.

•
Boolean!non-null

Whether the billing attempt is still processing.

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?