---
updatedAt: 2025-09-05T16:29:11.000Z
agentTools:
  projectIndex: https://docs.crezco.com/llms.txt
---

# Migrate from v2024-06-30

* Pay Run lifecycle changes
  * Expect that newly-created Pay Runs and Payables begin with a status of `Draft` instead of `Open`
  * Expect Pay Runs and Payables to move from status `Draft` to `Open` when [Checkout](https://docs.crezco.com/reference/post_organisations-organisationid-pay-runs-payrunid-checkout) is called on the Pay Run
  * Continue to expect that Pay Runs and Payables in `Open` status can time out and become `Cancelled` after 10 minutes of no activity, but `Draft` Pay Runs and Payables cannot
* Replace uses of FX Estimate endpoint (removed) with [Create pay run](https://docs.crezco.com/reference/post_organisations-organisationid-pay-runs-1)
  * [Create pay run](https://docs.crezco.com/reference/post_organisations-organisationid-pay-runs-1) and [Get pay run](https://docs.crezco.com/reference/get_organisations-organisationid-pay-runs-payrunid) now return estimated currency conversion rates and fees, before the customer has confirmed a rate during the payment flow
  * Speculative calls to [Create pay run](https://docs.crezco.com/reference/post_organisations-organisationid-pay-runs-1) are accepted, such pay runs can be created and abandoned without consequence
* Replace uses of Get Organisation By PartnerClientId (removed) with [Get Organisation](https://docs.crezco.com/reference/get_organisations-organisationid)
* Payable object changes
  * FX Fees are now part of the Fees object in a Payable
  * `transferFee` and `exchangeFee` have been replaced with `providerFixedFee` and `providerVariableFee` to describe the fees that are flat and proportional to Payable value respectively (see [Get pay run](https://docs.crezco.com/reference/get_organisations-organisationid-pay-runs-payrunid) and [Collecting Fees](https://docs.crezco.com/reference/collecting-fees) for details)
  * Payable `amount` is now `recipientAmount` for clarity
  * Payable `amountReturned` is now `reversedAmount` to match the Reversed status it is relevant to
* [Connect](https://docs.crezco.com/reference/get_organisations-organisationid-connect) and [Checkout](https://docs.crezco.com/reference/post_organisations-organisationid-pay-runs-payrunid-checkout) now return 200 OK with a `{ "url": "https://example.com" }` response instead of a 302 Found response, to be consistent with [Verification flow](https://docs.crezco.com/reference/post_organisations-organisationid-verify)
* [Checkout](https://docs.crezco.com/reference/post_organisations-organisationid-pay-runs-payrunid-checkout) is now a POST endpoint instead of a GET endpoint as it has the side effect of moving a Draft Pay Run to Open
* Update webhook subscriptions
  * Breaking change: Payable webhook payload is now the entire Payable object as described in [Get pay run](https://docs.crezco.com/reference/get_organisations-organisationid-pay-runs-payrunid)
  * There are no other breaking changes in webhook data, but new additions such as FX estimates and Failure Insights will only appear in v2025-01-31
  * Call [Register webhook](https://docs.crezco.com/reference/post_webhooks) for each of the webhook events that you wish to subscribe to in the new version of the API
  * Call [Delete existing webhook](https://docs.crezco.com/reference/delete_webhooks-webhookid)for each webhook for the old version to which you are still subscribed
* Begin sending a `Crezco-Version` header with value of `2025-01-31` with all API calls