Skip to content

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_id and attributed_manager_id are 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