Skip to main content
Log inSign up
Anchor to subscriptionBillingAttempt

subscriptionBillingAttempt

query

Returns a SubscriptionBillingAttempt by ID.

ID!required

The ID of the SubscriptionBillingAttempt to return.


Was this section helpful?

Anchor to SubscriptionBillingAttemptSubscriptionBillingAttempt

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.

completedAt

The date and time when the billing attempt was completed.

createdAt
non-null

The date and time when the billing attempt was created.

id
non-null

A globally-unique ID.

idempotencyKey
non-null

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

nextActionUrl

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

order

The result of this billing attempt if completed successfully.

originTime

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.

paymentGroupId

The reference shared between retried payment attempts.

paymentSessionId

The reference shared between payment attempts with similar payment details.

processingError

Error information from processing the billing attempt.

ready
non-null

Whether the billing attempt is still processing.

respectInventoryPolicy
non-null

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

subscriptionContract
non-null

The subscription contract.

transactions
non-null

The transactions created by the billing attempt.

errorCode
Deprecated

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

errorMessage
Deprecated

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?