HomeGuidesAPI ReferenceChangelog
Terms of Use
Changelog

3.249.0 release notes

  1. ⚠️ Breaking changes
    1. Changed the Korean language tag from ko to ko-KR for language, locale, and notifications.billing.settlementReportLanguage on POST /resources/partner-invites/v2.0, GET /resources/partner-invites/v2.0, GET /resources/partner-invites/v2.0/{partnerInvite}, PATCH /resources/partner-invites/v2.0/{partnerInvite}, POST /resources/partners/v2.0, GET /resources/partners/v2.0, GET /resources/partners/v2.0/{partner}, PATCH /resources/partners/v2.0/{partner}, POST /resources/users/v1.1, PATCH /resources/users/v1.1/{user}, and POST /actions/partner/v1.0/{partner}/set-custom-fields. Consumers must send ko-KR instead of ko and support ko-KR in responses.
    2. Changed the number returned for transactions created through a Worldline ad hoc payment portal on POST /resources/transactions/v1.0 to include a provider-specific prefix. Consumers that validate or parse transaction numbers must accommodate the new format.
  2. New features
    1. Added experimental settlement-override endpoints for partner contracts: GET and POST /resources/partner-contracts/v1.0/{partnerContract}/settlement-overrides, plus GET, PATCH, and DELETE /resources/partner-contracts/v1.0/{partnerContract}/settlement-overrides/{settlementOverride}. Settlement overrides set AC and/or DC partner-share percentages for a specified driver population, with the lowest matching priority taking precedence.
    2. Added the optional include query parameter to GET /resources/partner-contracts/v1.0/{partnerContract}. Set it to settlementOverrides to embed the contract's active settlement overrides, newest first, in the settlementOverrides response property.
    3. Added the optional display.totalCostFallbackMessage property to Tariff group requests on POST /resources/tariff-groups/v1.0 and PUT /resources/tariff-groups/v1.0/{tariffGroup}, and to Tariff group responses from GET /resources/tariff-groups/v1.0, POST /resources/tariff-groups/v1.0, GET /resources/tariff-groups/v1.0/{tariffGroup}, and PUT /resources/tariff-groups/v1.0/{tariffGroup}. It specifies the message shown when a charging session ends but its final cost cannot be retrieved.