MngUpdateCashierTransaction¶
Updates limited lifecycle and meta fields of an existing Cashier transaction.
This method is intended for BackOffice correction and manual review flows. It does not directly credit or debit a trading account.
Access¶
SESSION_MANAGER, SESSION_ADMIN, SESSION_DEALER,
SESSION_CRM_MANAGER, SESSION_CRM_ADMIN.
Requires transaction scope access. Updating non-status fields or neutral statuses requires set_finance; moving to credited/completed/provider-confirmed requires approve_finance; moving to failed/cancelled/refunded/chargeback requires decline_finance.
Request Parameters¶
| Name | Type | Required | Description |
|---|---|---|---|
id |
int | Yes | Cashier transaction id |
status |
int | No | Transaction status, 0..11; ledger-owned statuses are rejected as described below |
failure_reason |
string | No | Failure reason, max 256 UTF-8 bytes |
comment |
string | No | Manager comment, max 512 UTF-8 bytes |
metadata_json |
string | No | Metadata JSON string |
reject_reason |
string | No | Rejection reason, max 512 UTF-8 bytes |
Request Example¶
{
"command": "MngUpdateCashierTransaction",
"extID": "1",
"data": {
"id": 15,
"status": 9,
"reject_reason": "Waiting for provider settlement report"
}
}
Response¶
Returns the updated transaction object.
{
"transaction": {
"id": 15,
"customer_id": 5,
"login": 2000009,
"type": 0,
"provider": "stripe",
"method": "card",
"provider_config_id": 1,
"provider_payment_id": "pi_123",
"amount": 250.0,
"currency": "USD",
"account_currency": "USD",
"converted_amount": 250.0,
"conversion_rate": 1.0,
"status": 9,
"failure_reason": "",
"idempotency_key": "0f9bb0e7-642d-4b70-b458-62e3993c7d2d",
"comment": "",
"metadata_json": "{}",
"source": 0,
"approved_by": 0,
"approved_time": 0,
"processed_by": 0,
"processed_time": 0,
"attributed_manager_id": 12,
"owner_manager_id": 12,
"reject_reason": "Waiting for provider settlement report",
"created_time": 1779270000,
"updated_time": 1779270200
}
}
Notes¶
owner_manager_idandattributed_manager_idare not accepted by this command. Both are written once at creation and never change; see Transaction Ownership.- The update is durably written to SQLite before it becomes visible in the Cashier runtime cache.
- A status update only changes the Cashier transaction record; it does not call a provider module or submit a balance operation. This API has no manager Cashier commands for provider polling, cancel, refund, or external payout.
Set reject_reason to update the rejection reason without overwriting the
customer's original comment. Omitting comment preserves its stored value.
Status 3 (credited), 10 (completed), and 11 (processing_ledger) are
controlled by the finance ledger: including any of these values in status
returns 409 CASHIER_STATUS_MANAGED_BY_LEDGER, even if it matches the current
value. A transaction already in one of these states cannot be moved to another
status through this command. Omit status when changing comments or metadata
on such a transaction.
Errors¶
| Code | Error | Description |
|---|---|---|
400 |
INVALID_DATA |
Invalid id, status, or field length |
403 |
RET_NOT_ENOUGH_RIGHTS |
Caller lacks scope or required finance permission |
404 |
RET_ERR_NOTFOUND |
Transaction was not found |
409 |
CASHIER_STATUS_MANAGED_BY_LEDGER |
Requested status is ledger-owned or would change a ledger-owned transaction status |