Transtraction in short Months (less the 31 days)

Ran Cohen's Avatar

Ran Cohen

03 Mar, 2019 07:02 AM


This year (2019) February had 28 days (liked every 3 years out of 4). I've noted that Recurrent charges that were supposed to be transacted in the 29,30,31 were not transacted in the overall transactions for this month but were transacted on March 1st, 2nd, and 3rd. respectively.

This cause a postpone in the settlements that ware supposed to be transferred by the end of Feb and also a mismatch in the stats. I assume also it will occur in every month that has less than 31 days in it. Can it be configured for concluding all of the months payments in the same month ?


  1. Support Staff 1 Posted by Meghan Turner on 07 Mar, 2019 04:32 PM

    Meghan Turner's Avatar

    Hi Ran,

    When a customer is set to bill monthly, Cheddar bills them every 30 days. If customers have a bill date on the 29th, 30th, or 31st and the subsequent month doesn't have enough days, the customer's bill will be on the 1st, 2nd, or 3rd of the following month.

    Right now there isn't a built-in configuration option to change the monthly billing cycle, though we'd like to offer that in the future. However, if you want to ensure that a customer's bill won't be moved to the following month, you can change the bill date for any customer who's monthly billing cycle begins on the 29th, 30th, or 31st.

    There are a number of ways you can update a customer's bill date. If you're using the API to create a customer, you can set a specific bill date using the subscription[initialBillDate] parameter in the customers/new call (see the docs here for more info). If that parameter is set, it overrides the pricing plan configuration for first bill date.

    If you'd like to change the bill date after the customer has been created, you can do that manually in the user interface in the 'Edit Subscription' section of the customer profile or you can use webhooks to automate the process. Listen for the new subscription webhook and/or plan change webhooks (webhook docs here). The subscription[invoice][billingDatetime] of the customer's current pending invoice is included in the hook payload. Your listener logic can examine that date and if the customer is set to bill on the 29th, 30th, or 31st, send Cheddar a /customers/edit-subscription/ API call to change the bill date to the 28th.

    Hope that helps, but let me know if you have any questions!


Discussions are closed to public comments.
If you need help with Cheddar please start a new discussion.

Keyboard shortcuts


? Show this help
ESC Blurs the current field

Comment Form

r Focus the comment reply box
^ + ↩ Submit the comment

You can use Command ⌘ instead of Control ^ on Mac

Recent Discussions

28 Mar, 2024 10:45 PM
24 Jan, 2024 08:33 AM
11 Jan, 2024 07:13 AM
30 Nov, 2023 02:07 AM
22 Nov, 2023 08:41 AM