Have your say in Community Polls: What was/is your greatest motivation to start your own business?
Our Partner & Developer boards on the community are moving to a brand new home: the .dev community forums! While you can still access past discussions here, for all your future app and storefront building questions, head over to the new forums.

Re: Recurring Application Charge - What happens when it reaches a month?

Recurring Application Charge - What happens when it reaches a month?

nikrolas
Shopify Partner
4 0 0

Hi, 

 

I have recurring application charges in my application where I have a limit based off of the current plan. If they exceed the limit within the month, they have to wait until the next billing cycle where the limits reset.

 

With the recurring application charges, when 30 days roll around, does the shopify record that contains the application charge also update? For example, does billing_on field on the recurring application charge record update to the next month?

Or do we have to keep track of this 

Replies 6 (6)

ShopifyDevSup
Shopify Staff
1453 238 525

Hi @nikrolas,

 

I would review the developer documents on creating a recurring charge based on usage and if you are also able to subscribe to webhooks to monitor usage as well. 

 

It states: 

 

Merchants can use the Shopify admin to change their capped amount. This is the maximum amount of usage to bill for within the Shopify 30-day billing cycle.

To receive notifications when merchants change the capped amount, subscribe to the GraphQL Admin API's APP_SUBSCRIPTIONS_UPDATE topic.

To receive a notification when merchants reach or exceed 90% of their capped amount, subscribe to the GraphQL Admin API's APP_SUBSCRIPTIONS_APPROACHING_CAPPED_AMOUNT topic.
 

Hope that helps! 

Developer Support @ Shopify
- Was this reply helpful? Click Like to let us know!
- Was your question answered? Mark it as an Accepted Solution
- To learn more visit Shopify.dev or the Shopify Web Design and Development Blog

nikrolas
Shopify Partner
4 0 0

@ShopifyDevSup thanks for the reply!

Quick follow up question - does the Recurring Application Charge record on shopify's side change after 30 days? For example, if the customer has a recurring application charge with a billing_on date of Jan 1, 2022 and 30 days pass and they are charged again, does that same record now have an updated billing_on date of Jan 31, 2022?


danhho
Shopify Partner
22 1 6

Are you have answer for above billing_on issue?

ShopifyDevSup
Shopify Staff
1453 238 525

Hey @danhho

The billingOn date is updated on a 30 day billing cycle. 

For example, if the first charge is on January 1 and assuming February has 29 days, the next three billingOn charges will be on:

1. January 31 (30 days after January 1)
2. March 1 (30 days after January 31)
3. March 31 (30 days after March 1)

This should be reflected in the billingOn date. 

Also, keep in mind that this is the date of the application charge and when it's added to the merchant invoice. The merchant may be on a different 30 day billing cycle so the date of the payout will be different. The merchants billing cycle is currently not available through the API or dashboard so here's more context on the merchant billing cycles and how it relates to app charges: https://help.shopify.com/en/manual/your-account/manage-billing/your-invoice/apps 

Hope that helps! 

 

- Kyle G.

Developer Support @ Shopify
- Was this reply helpful? Click Like to let us know!
- Was your question answered? Mark it as an Accepted Solution
- To learn more visit Shopify.dev or the Shopify Web Design and Development Blog

danhho
Shopify Partner
22 1 6

Hi @ShopifyDevSup , thanks for your explain,
One more quickly question, when merchant change plan (upgrade or downgrade), the billingOn will day billingOn of old plan? Is it right?

Example: if merchant used 10 day with 10$ plan (billingOn: January 1) then they upgrade to 20$ plan, now the field billingOn of new plan is still January 1, it not 30 days after new plan. is it right? 

Please confirm it. Thanks in advance!

ShopifyDevSup
Shopify Staff
1453 238 525

Hey @danhho , the best resource to explain this will be our documentation on proration, where it outlines when a charge stays on the same cycle (same billingON date) and when the date will change 

- https://shopify.dev/docs/apps/billing/subscriptions#proration 

You also have some control over whether changes get applied immediately or on the next billing cycle this with the appReplacementsSubscriptionBehaviour enum 

- Kyle G. 

Developer Support @ Shopify
- Was this reply helpful? Click Like to let us know!
- Was your question answered? Mark it as an Accepted Solution
- To learn more visit Shopify.dev or the Shopify Web Design and Development Blog