Subscription API Billing Attempt - charge $0 but failed

Retired Boards Appdev Graphql Basics And Troubleshooting

Topic summary

Issue: A Shopify Subscription API billing attempt for $0.00 AUD fails with errorCode “PAYMENT_METHOD_DECLINED” and errorMessage “Your card has insufficient funds.” The customer receives an email prompting them to update their payment method.

Key question: Whether a $0 billing attempt still contacts the bank/payment processor.

Context: Merchant (Shopify Plus) sought help after Plus support redirected them to the community. They’re using the Subscription API Billing Attempt (a charge operation for a subscription invoice).

Shopify response: It’s unusual for a $0 charge to return an “insufficient funds” error. The previously shared example is too old to investigate. A recent example (within the last 7 days) is needed to diagnose.

Action items:

  • Submit a new report via Partner Support Contact (Email).
  • Select the “App Development & API” category.
  • Include details of a recent failed attempt for deeper investigation.

Status: Unresolved. No confirmation provided on whether $0 attempts reach the payment processor. Next step depends on partner supplying a recent case via support.

Notes: AUD = Australian dollars. No attachments or media are central to this discussion.

Summarized with AI on February 4. AI used: gpt-5.
1

Hi Shopify Team,

We are using the Shopify Subscription API to make a Billing Attempt. The total price amount is $0.00 AUD.

However, even with that, the billing attempt failed. It returns

“errorMessage”: “Your card has insufficient funds.”,
“errorCode”: “PAYMENT_METHOD_DECLINED”,

And customer receives an email notification that they need to update the payment method.

Do the billing attempt always contact the bank even the total amount is $0 AUD?

Thanks

Looking forward to hearing from you

Jiazhen

2

Can anyone from Shopify API team help? I’ve been advised by the Shopify Plus support to look for help from this community …

Thanks

Jiazhen

3

Hi Jiazhen,

Thanks for your post. It seems unusual that a charge for $0 would get an ‘insufficient funds’ error message but the example provided in the conversation with Support that you mentioned was too long ago for us to be able to investigate for more details.

If you have a more recent example from within the past 7 days we recommend submitting a new report through the ‘Email’ option in the [Partner Support Contact] menu using the ‘App Development & API’ category to enable a deeper investigation into the issue. Thank you.