---
updatedAt: 2025-09-08T20:31:30.000Z
agentTools:
  projectIndex: https://docs.rainforestpay.com/llms.txt
---

# 2024-10-16

How to upgrade to the Rainforest API version 2024-10-16

The following changelog will explain the backwards-incompatible changes you'll need to make to your integration with the Rainforest API before upgrading to the 2024-10-16 version.

See the guide for [API version upgrades](https://docs.rainforestpay.com/docs/api-version-upgrades) on how to upgrade to this version.

## Changelog

* \[**MAJOR**] The [chargeback](https://docs.rainforestpay.com/reference/get_chargeback) status `PENDING` has been replaced with the following statuses. For more information, see the guides for [understanding chargebacks](https://docs.rainforestpay.com/docs/understanding-chargebacks).
  * `INQUIRY_ACTION_REQUIRED`
  * `INQUIRY_RESPONDED`
  * `DISPUTE_ACTION_REQUIRED`
  * `CHARGEBACK_PROCESSING`
  * `PREARBITRATION_PROCESSING`
  * `ARBITRATION`
  * `PROVISIONAL_WIN`
* \[**MAJOR**] In [create payment method config](https://docs.rainforestpay.com/reference/create_payment_method_config) endpoint, a new field`billable_merchant_id` is required.
  * Setting a billable merchant ID on each payment method will allow the platform to pass on the fees for running processes such as Card Account Updater.
* New payin statuses:
  * \[**MAJOR**] `RETURNED` for when ACH payins are returned before being available for deposits. For more information, see the guides for [understanding ACH returns](https://docs.rainforestpay.com/docs/understanding-ach-returns#ach-payin-and-ach-return-in-the-same-deposit).
  * `AUTHORIZED` for visibility on authorization prior to processing.
* The following endpoints on API keys have been updated from `PUT` to `POST`:
  * [Enable API key](https://docs.rainforestpay.com/reference/enable_api_key) endpoint
  * [Disable API key](https://docs.rainforestpay.com/reference/disable_api_key) endpoint
* The deprecated field `level_2_3.mcc_code` has been removed from the [payin config](https://docs.rainforestpay.com/reference/get_payin_config) resource. The field `level_2_3.commodity_code` should be used instead.
* The deprecated field  `supported_capabilities` has been removed from the following:
  * [Payin config](https://docs.rainforestpay.com/reference/get_payin_config) resource
  * [Payment method config](https://docs.rainforestpay.com/reference/get_payment_method_config) resource
* The deprecated field `result_code` has been removed from the following resource and endpoints. The field `refusal_code` should be used instead.
  * [Payin](https://docs.rainforestpay.com/reference/get_payin) resource
  * [Void or refund payin](https://docs.rainforestpay.com/reference/void_or_refund_payin) endpoint
  * [List payments](https://docs.rainforestpay.com/reference/list_payments) endpoint
* The deprecated params `start_time` and `end_time` have been removed from the following endpoints. The fields `created_at.start` and `created_at.end` should be used instead.
  * [List payins]()  endpoint
  * [List payments](https://docs.rainforestpay.com/reference/list_payments) endpoint
* The deprecated params `created_at_start`, `created_at_end`, `updated_at_start`, and `updated_at_end` have been removed from the following endpoints. The fields `created_at.start`, `created_at.end`, `updated_at.start`, and `updated_at.end` should be used instead.
  * [List merchants](https://docs.rainforestpay.com/reference/list_merchants) endpoint
  * [List merchant applications](https://docs.rainforestpay.com/reference/list_merchant_applications) endpoint
* The undocumented field `rainforest_internal_state` has been removed from the following resources:
  * [Merchant](https://docs.rainforestpay.com/reference/get_merchant) resource
  * [Merchant application](https://docs.rainforestpay.com/reference/get_merchant_application) resource
* The undocumented fields `merchant_application_state` and `merchant_state` have been removed from the [create merchant](https://docs.rainforestpay.com/reference/create_merchant) endpoint.