BVbvnk
Fiat Payments

Execute wallet action

Changed on

Executes a lifecycle action on a wallet: TERMINATE, BLOCK, or UNBLOCK. A non-empty comment explaining the reason is required.

post/ledger/v2/wallets/{id}/actions

Request

Path parameters

idstring required
Example:a:24092328494070:G5i4XZ9:1

The wallet identifier.

Request body

action'TERMINATE' | 'BLOCK' | 'UNBLOCK' required

Type of wallet action to execute:

  • TERMINATE: Permanently deletes the wallet. This action cannot be reversed. For fiat wallets, the linked virtual account is also closed (not applicable to the crypto wallets). The wallet balance must be zero before termination—transfer funds to another wallet first if needed.

  • BLOCK: Temporarily freezes the wallet. A blocked wallet cannot receive deposits or make payments and typically has the INACTIVE status.

  • UNBLOCK: Unfreezes the blocked wallet.

comment'COMPLIANCE' | 'OPERATION' | 'OFFBOARDING' | 'CLIENT_REQUEST' | 'OTHER' required

Reason the wallet action is being executed.

Response

No Content. The action was applied successfully.

Changes