---
title: SubscriptionBillingAttemptInput - GraphQL Admin
description: The input fields required to complete a subscription billing attempt.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionBillingAttemptInput
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionBillingAttemptInput.md
api_name: admin
api_type: graphql
type: input-object
---

# Subscription​Billing​Attempt​Input

input\_object

The input fields required to complete a subscription billing attempt.

## Fields

* actor

  [Subscription​Actor](https://shopify.dev/docs/api/admin-graphql/latest/enums/SubscriptionActor)

  The actor who initiated a subscription action.

* billing​Cycle​Selector

  [Subscription​Billing​Cycle​Selector](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/SubscriptionBillingCycleSelector)

  Select the specific billing cycle to be billed. Default to bill the current billing cycle if not specified.

* idempotency​Key

  [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  non-null

  A unique key generated by the client to avoid duplicate payments. For more information, refer to [Idempotent requests](https://shopify.dev/api/usage/idempotent-requests).

* inventory​Policy

  [Subscription​Billing​Attempt​Inventory​Policy](https://shopify.dev/docs/api/admin-graphql/latest/enums/SubscriptionBillingAttemptInventoryPolicy)

  Default:PRODUCT\_VARIANT\_INVENTORY\_POLICY

  The behaviour to follow when creating an order for a product variant when it's out of stock.

* origin​Time

  [Date​Time](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime)

  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.

* payment​Processing​Policy

  [Subscription​Billing​Attempt​Payment​Processing​Policy](https://shopify.dev/docs/api/admin-graphql/latest/enums/SubscriptionBillingAttemptPaymentProcessingPolicy)

  Default:FAIL\_UNLESS\_VALID\_PAYMENT\_METHOD

  Select payment processing policy for the billing attempt. Defaults to FAIL\_UNLESS\_VALID\_PAYMENT\_METHOD.

***

## Mutations using this input

* [subscription​Billing​Attempt​Create.subscriptionBillingAttemptInput](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingAttemptCreate#arguments-subscriptionBillingAttemptInput)

  ARGUMENT

***

## Map

### Mutations using this input

* [subscription​Billing​Attempt​Create.subscriptionBillingAttemptInput](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingAttemptCreate#arguments-subscriptionBillingAttemptInput)