Billing Cycle for RecurringApplicationCharges

Retired Boards Appdev Graphql Basics And Troubleshooting

Topic summary

A developer is seeking detailed API documentation about the billing cycle timing for RecurringApplicationCharges, specifically regarding when the billing_on value transitions to the next cycle.

Current Setup:

  • Using $0 RecurringApplicationCharges mixed with UsageCharges
  • Goal: Maintain 1:1 invoice alignment in their system

Observed Issue:

  • The billing_on value appeared to be the day after the last day of a given cycle
  • Initially expected the cycle end at 00:00:00 UTC
  • Upon further inspection, saw the same value (May 10) until roughly noon EDT on the tenth

Key Question:
The exact turnover point for billing cycles is unclear, and existing documentation doesn’t provide sufficient detail about this timing.

Summarized with AI on November 20. AI used: claude-sonnet-4-5-20250929.
1

Is there any API specific documentation regarding the billing cycle when using RecurringApplicationCharges? The documentation here doesnt really offer much regarding the exact point at which it turns over, specific to the billing_on value returned. We believed that value was the day after the last day in a given cycle, where the end was at 00:00:00UTC, but after further inspection, saw the same value(May 10) on the tenth until roughly noon EDT.

For additional context, we use RecurringApplicationCharges($0 fee) mixed with UsageCharges. Our goal is to be able to maintain 1:1 invoices in our system.

1 Like