Version: 2024-07-30
Billing
- NEW Delete Credit Grant
- UPDATED Create billing schedule endpoint
- Updated
pricesto match models for Prices API
- Updated
- UPDATED Update billing schedule endpoint
- Removed
typefrom request and response models - Removed
discountsfrom Billing Schedule creation request - these should now be provided as part of a Phase - Renamed
createAsDrafttoisDrafton creation request - Renamed
collectionPaymentProvidertopaymentProvideron creation request - Removed
sequenceAccountIdfrom response model - Removed
priceIdsfrom response model - Updated
pricesto match models for Prices API
- Removed
- UPDATED Get billing schedule endpoint
- Updated
pricesto match models for Prices API - Addition:
contractId
- Updated
- UPDATED List billing schedules endpoint
- Updated
pricesto match models for Prices API
- Updated
- UPDATED Activate billing schedule endpoint
- Updated
pricesto match models for Prices API - Addition:
Added dryRun queryParam to validate without persisting - Removed:
Removed dryRun queryParam to validate without persisting
- Updated
- UPDATED Archive billing schedule endpoint
- HTTP method updated from
PUTtoPOST - Updated
pricesto match models for Prices API
- HTTP method updated from
- NEW Duplicate a billing schedule endpoint
- NEW Validate taxes on a billing schedule
Collections
- NEW Get or create payment settings endpoint
- NEW Update payment settings endpoint
- NEW Get or create Stripe collection settings endpoint
- NEW Update Stripe collection settings endpoint
Customers
- REMOVED Delete customer endpoint
- UPDATED Archive customer endpoint
- HTTP method updated from
PUTtoPOST - Added field
organizations - Removed
contactName,emailandbillingEmailsfields in favour ofcontacts - Removed field
telephone - Removed field
deletedAt - Addition:
statusto request and response
- HTTP method updated from
- UPDATED Create customer endpoint
- Added optional
parentIdfield to request - Added field
organizationsto response - Removed
contactName,emailandbillingEmailsfields in favour ofcontactsin request and response - Removed field
telephonefrom request and response - Removed field
deletedAtfrom response - Addition:
statusto request and response
- Added optional
- UPDATED Update customer endpoint
- Added optional
parentIdfield to request - Added field
organizationsto response - Removed
contactName,emailandbillingEmailsfields in favour ofcontactsin request and response - Removed field
telephonefrom request and response - Removed field
deletedAtfrom response - Addition:
statusto request and response
- Added optional
- UPDATED List customers endpoint
- Added field
organizations - Removed
contactName,emailandbillingEmailsfields - Removed field
telephone - Removed field
deletedAt
- Added field
- UPDATED Get customer endpoint
- Added field
organizations - Removed
contactName,emailandbillingEmailsfields in favour ofcontacts - Removed field
telephone - Removed field
deletedAt - Addition:
statusto request and response
- Added field
- NEW Create customer organization endpoint
- NEW Add customer organization member endpoint
- NEW Replace customer organization members endpoint
Invoices
- NEW Get invoice render settings endpoint
- NEW Update invoice render settings endpoint
- NEW Mark invoices as sent endpoint Mark credit note as sent endpoint added
- NEW List Currency Conversions for an Invoice
Products
- UPDATED Archive list price endpoint
- HTTP method updated from
PUTtoPOST
- HTTP method updated from
Quotes
Taxes
- UPDATED Archive tax rate endpoint
- HTTP method updated from
PUTtoPOST
- HTTP method updated from
Version: 2024-05-09
Naming improvements and simplifications across billing, customers, products, taxes and usage APIs. Further details below.Billing
-
Removed
POST /discountsendpoint. -
Renamed
externalIdstointegrationIdsinPricerequests and updated model to be{service: string, id: string}. -
Renamed
externalIdstointegrationIdsinPriceresponses and updated model to be{service: string, id: string, lastSynced: timestamp}. -
Removed
sequenceAccountIdanddeletedAtfrom listPriceresponse model. -
Removed
sequenceAccountIdfromPricedeletion response model. -
Removed
sequenceAccountIdfromPricecreation response model. -
Renamed
parameterstocustomMetricParametersinPricerequest and response models. -
Updated the following fields on seat-based pricing structure:
- Renamed
seatTypeIdtoseatMetricId - Removed values
USE_FIRSTandPRORATE_ALL_CHANGESfromprorationStrategy - Renamed
includedSeatstocontractedMinimumSeats - Removed
chargeMethod
- Renamed
-
Updated the following fields on the
Billing Schedulemodels:- Removed
typefrom request and response models - Removed
discountsfromBilling Schedulecreation request - these should now be provided as part of aPhase - Renamed
createAsDrafttoisDrafton creation request - Renamed
collectionPaymentProvidertopaymentProvideron creation request - Removed
sequenceAccountIdfrom response model - Removed
priceIdsfrom response model
- Removed
Collections
- Updated the following URLs
POST /billing-schedule-settings->POST /payments/settings/billing-schedulesGET /billing-schedule-settings/for-billing-schedule/{id}->GET /payments/settings/billing-schedules/for-billing-schedule/{id}GET /billing-schedule-settings/{id}->GET /payments/settings/billing-schedules/{id}PUT /billing-schedule-settings/{id}->PUT /payments/settings/billing-schedules/{id}DELETE /billing-schedule-settings/{id}->DELETE /payments/settings/billing-schedules/{id}POST /invoice-settings->POST /payments/settings/invoicesGET /invoice-settings/for-invoice/{id}->GET /payments/settings/invoices/for-invoice/{id}GET /invoice-settings/{id}->GET /payments/settings/invoices/{id}PUT /invoice-settings/{id}->PUT /payments/settings/invoices/{id}DELETE /invoice-settings/{id}->DELETE /payments/settings/invoices/{id}POST /customer-settings->POST /payments/settings/customersGET /customer-settings/{id}->GET /payments/settings/customers/{id}PUT /customer-settings/{id}->PUT /payments/settings/customers/{id}DELETE /customer-settings/{id}->DELETE /payments/settings/customers/{id}
Customers
- Renamed
externalIdstointegrationIdsinCustomerrequests and updated model to be{service: string, id: string}. - Renamed
externalIdstointegrationIdsinCustomerresponses and updated model to be{service: string, id: string, lastSynced: timestamp}.
Products
- Removed
sequenceAccountIdfromProductrequest and response models.
Taxes
- Removed
subRatesfromTax Raterequest and response models. - Removed
sequenceAccountIdfromTax Rateresponse models.
Usage
- Renamed
Seat TypestoSeat Metricsand updated URLs to be/seat-metrics. - Removed
sequenceAccountIdfromSeat Metricresponse model. - Renamed
sequenceUserIdtocreatedByonSeat Metricresponse model and removed it from request model. - Renamed
keytoseatTypeonSeat Metricrequest and response models. - Renamed
Seat SnapshotstoSeat Eventsand updated URLs to be/seat-events. - Removed
seatChangesfromSeat Eventrequest and response models.