---
title: "Update Cashout Status"
method: PUT
path: "/v3/cashout/status"
tags: ["Cashout"]
---

# Update Cashout Status

`PUT /v3/cashout/status`

This API allows you to change the status of a cashout.
The primary use case is to update a cashout from PENDING to ON_HOLD, or from ON_HOLD to PENDING.
A cashout in ON_HOLD will not be processed until it's set back to PENDING. This is useful for KYC checks.
Only cashouts in PENDING status can be updated to ON_HOLD. Once a cashout is DELIVERED, it cannot be cancelled via this status update.
Cashouts in ON_HOLD reserve funds from your balance.

## Headers

- `Content-Type` 'application/json', required
- `Payload-Signature` string, required

## Request body

- CashoutStatusUpdateRequest
  - `login` string, required — Your D24 CASHOUTS API login key. Found in Merchant Panel: Settings → API Access.
  - `pass` string, required — Your D24 CASHOUTS API passphrase. Found in Merchant Panel: Settings → API Access.
  - `cashout_id` number, required — The unique identifier of the cashout on D24's end, obtained from the Create Cashout Endpoint.
  - `status` 'ON_HOLD' | 'PENDING', required — The status to be assigned to the cashout.

## Response `200`

The status of the cashout was successfully updated. The response body reflects the cashout's new or current status.

- CashoutStatusSuccessResponse
  - `cashout_status` integer — Numeric code representing the cashout's current status.
  - `cashout_status_description` string — Textual description of the cashout's current status.
  - `rejection_code` integer, nullable — If the cashout status is 'Rejected', this code indicates the reason for rejection.
  - `rejection_reason` string, nullable — If the cashout status is 'Rejected', this provides a textual explanation for the rejection.

## Other responses

- `400` — Bad Request. This can occur due to various reasons such as an invalid status transition (e.g., trying to change status from DELIVERED).
- `401` — Unauthorized. Invalid API credentials (login/pass) or Payload-Signature.
- `412` — Precondition Failed. The specified `cashout_id` was not found.
- `500` — Internal Server Error. An unexpected error occurred on the server side.

---

[API](https://skmtc.net/d24/apis/docs-d24-com.md) · [All operations](https://skmtc.net/d24/apis/docs-d24-com/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/d24/docs-d24-com/versions/fb0e2ddec198/schema)