Create unpaid orders from subscription billing attempts

In the API 2026-04 release candidate version, you can now include a new field called paymentProcessingPolicy when creating a billing attempt using the subscriptionBillingAttemptCreate mutation. A billing attempt is an action to charge a customer based on their subscription.

The paymentProcessingPolicy field determines how the billing attempt is handled depending on the validity of the payment method:

• If you don't provide the paymentProcessingPolicy field, or if you set it to FAIL_UNLESS_VALID_PAYMENT_METHOD, a valid payment method is necessary to create an order successfully.
• Alternatively, if you set the value to SKIP_PAYMENT_AND_CREATE_UNPAID_ORDER, the system will create an unpaid order even if there isn't a valid payment method available on the subscription contract.

For detailed implementation instructions, please refer to our documentation on building a subscription contract.