Orb What's new in Orb logo
Back to Homepage

What's new in Orb

Subscribe to Updates

Labels

  • All Posts
  • API
  • Dashboard
  • Integrations
  • Performance
  • Subscription Management
  • Billable Metrics
  • Feature
  • Invoices
  • Customer Portal
  • Improvement
  • Tax
  • IT Administration
  • Revenue Reporting
  • Webhooks
  • Plan Configuration
  • Developer Experience
  • Pricing Models
  • Usage Data
  • Coupons
  • Credits
  • Data Exports

Jump to Month

  • September 2025
  • August 2025
  • July 2025
  • June 2025
  • May 2025
  • April 2025
  • March 2025
  • February 2025
  • January 2025
  • December 2024
  • November 2024
  • October 2024
  • September 2024
  • August 2024
  • July 2024
  • June 2024
  • May 2024
  • April 2024
  • March 2024
  • February 2024
  • January 2024
  • December 2023
  • October 2023
  • September 2023
  • August 2023
  • July 2023
  • June 2023
  • May 2023
  • April 2023
  • March 2023
  • February 2023
  • January 2023
  • December 2022
  • November 2022
  • October 2022
  • September 2022
  • August 2022
Changelog byAnnounceKit

Create yours, for free!

APISubscription ManagementInvoices
a week ago

API Update: new mark_as_paid field added to apply subscription change API

We have introduced a new mark_as_paid field on the apply subscription changes API. This new field marks all payable invoices as finalized and paid, and works in tandem with the is_payable_now field that exists on changed resources (see: https://changelog.withorb.com/api-update-is_payable_now-field-added-to-changed_resources.created_invoices-3pIhZC).

The previously_collected_amount field is optional. If not provided, we assume the amount was correctly collected and simply mark invoices as paid without touching the customer balance.

When both mark_as_paid and previously_collected_amount are provided, we mark all payable invoices as paid and decrement customer balance by (previously_collected_amount - total amount due). This should only be used when the amount collected outside the system differs from the total amount due. Note that the total amount due includes tax calculations, while the amount shown for pending changes does not include taxes (see: https://docs.withorb.com/essentials/pending-changes for more info).

Any negative customer balance will be automatically reflected on the next invoice.