Skip to content

POST Create Cashier Withdrawal

Endpoint

POST /cashier/withdrawal

Command

CreateCashierWithdrawal

Authorization

Requires SESSION_CUSTOMER.

Description

Creates a withdrawal transaction for the authenticated customer. The transaction is created with type = 1, provider = "manual", source = 1, and status = 9 (manual_review).

The account is not debited by this endpoint. A manager must process the transaction in CRM with MngProcessManualCashierTransaction.

Request Parameters

Name Type Required Description
login int Yes Trading account login owned by the authenticated customer
amount double Yes Positive withdrawal amount
currency string Yes Must match account currency
idempotency_key string No Customer-scoped idempotency key
comment string No Customer comment
metadata_json string No Additional metadata JSON string

Request Example

POST /cashier/withdrawal
Authorization: <CUSTOMER_JWT>
Content-Type: application/json

{
  "login": 2000009,
  "amount": 50.0,
  "currency": "EUR",
  "idempotency_key": "wd-001",
  "comment": "Bank withdrawal"
}

Response

Returns transaction.

Errors

HTTP Error Description
400 INVALID_DATA Invalid request
400 CURRENCY_CONVERSION_REQUIRED Currency does not match account currency
403 PERMISSION_DENIED Invalid customer session or account ownership
403 WITHDRAWAL_NOT_ALLOWED Withdrawals are disabled for this customer