---
title: "Generate cashout request"
method: POST
path: "/cashout"
tags: ["Cashout"]
---

# Generate cashout request

`POST /cashout`

This endpoint allows generating withdrawal requests (cashouts)

## Headers

- `Content-Type` string, required
- `Payload-Signature` string, required

## Request body

- CashoutRequest
  - `login` string, required — Your access key for the D24 CASHOUTS API
  - `pass` string, required — Your password key for the D24 CASHOUTS API
  - `external_id` string, required — Unique cashout ID on the merchant side
  - `country` string, required — Country of the cashout
  - `amount` number, required — Cashout amount
  - `currency` string — Currency in which the amount is specified
  - `document_id` string, required — Beneficiary's document ID
  - `document_type` string — Specified identity document type
  - `beneficiary_id` string — Beneficiary ID (for anonymous)
  - `beneficiary_name` string, required — Beneficiary's name
  - `beneficiary_lastname` string — Beneficiary's last name
  - `email` string — Beneficiary's email address
  - `phone` string — Beneficiary's phone number
  - `bank_code` number — Beneficiary's bank code
  - `bank_account` string — Beneficiary's bank account
  - `bank_branch` string — Bank branch of the beneficiary's account
  - `account_type` string — Beneficiary's account type
  - `address` string — Beneficiary's address
  - `city` string — Beneficiary's city
  - `postal_code` string — Beneficiary's postal code
  - `beneficiary_birthdate` string — Beneficiary's date of birth
  - `notification_url` string, required — URL where notifications will be sent
  - `comments` string — Comments about the cashout
  - `on_hold` boolean — Marks a cashout as on hold and does not process it until manually changed to pending
  - `type` string — Response format type

## Response `200`

Cashout request successfully created

- object
  - `cashout_id` string — Unique identifier for the generated cashout

## Other responses

- `400` — Request error (KYC error)
- `401` — Authentication error
- `412` — Data validation error

---

[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)