Release On-Hold Funds

Release a hold on funds in the wallet. Sandbox only.

This action transfers funds from the on-hold balance to the available balance. If the wallet does not have enough funds in the on-hold balance in the specified currency, the transfer fails.

This method triggers the Transfer Funds Between Balances webhook. This webhook contains the same information as the response.

This method is relevant for person and company wallets.

Note

Deprecated endpoint - POST /v1/account/balance/release

Rapyd will continue to support the deprecated endpoint until March 31, 2025.

Parameters

Request Header Parameters

Request Body Parameters

- amount
- Amount of the transfer. Decimal.
- currency
- Three-letter ISO 4217 code for the currency used in the amount field.
- ewallet
- ID of the wallet associated with the contact. String starting with ewallet_.

Response Parameters

- amount
- - Transactions - Amount of the transaction, in units of the currency defined in currency. Decimal, including the correct number of decimal places for the currency exponent, as defined in ISO 4217:2015.
  - Wallet Account Operations - Amount of the account limit.
- currency_code
- Three-letter ISO 4217 code for the currency used in the amount field.
- destination_account_id
- ID of the wallet owner's user. UUID.
- destination_balance_type
- Balance type that the funds are transferred to. See Wallet Balance Types. One of the following:
  - available_balance
  - on_hold_balance
  - received_balance
  - reserve_balance
- destination_transaction_id
- ID of the transaction with regard to the destination. String starting with wt_.
- destination_user_profile_id
- ID of the wallet owner's user. UUID.
- id
- ID of the transaction. UUID.
- source_account_id
- ID of the wallet owner's user. UUID.
- source_balance_type
- Balance type that the funds are transferred from. See Wallet Balance Types. One of the following:
  - available_balance
  - on_hold_balance
  - received_balance
  - reserve_balance
- source_transaction_id
- ID of the transaction with regard to the source. String starting with wt_.
- source_user_profile_id
- ID of the wallet owner's user. UUID.

/v1/ewallets/accounts/balance/release

Release On-Hold Funds

curl -X post
https://sandboxapi.rapyd.net/v1/ewallets/accounts/balance/release
-H 'access_key: your-access-key-here'
-H 'Content-Type: application/json'
-H 'idempotency: your-idempotency-parameter-here'
-H 'salt: your-random-string-here'
-H 'signature: your-calculated-signature-here'
-H 'timestamp: your-unix-timestamp-here'
-d '{
  "ewallet": "ewallet_4f8009d08b7b41e5d3b356494101d83b",
  "amount": 10,
  "currency": "USD"
}
'

{
    "status": {
        "error_code": "",
        "status": "SUCCESS",
        "message": "",
        "response_code": "",
        "operation_id": "a1d43ad7-705d-4706-b080-91c82518786a"
    },
    "data": {
        "id": "340e28e3-c74d-4fc2-8a35-ca75210be715",
        "source_transaction_id": "2a034d46-f1c4-4d88-862a-196bfb80a5d8",
        "destination_transaction_id": "baa78bf4-d071-47c1-bbeb-b8552820e91b",
        "source_user_profile_id": "4b791777-4c06-11ea-833c-02e199f7f6f5",
        "destination_user_profile_id": "4b791777-4c06-11ea-833c-02e199f7f6f5",
        "source_account_id": "f8a849ea-4c0a-11ea-833c-02e199f7f6f5",
        "destination_account_id": "f8a849ea-4c0a-11ea-833c-02e199f7f6f5",
        "source_balance_type": "on_hold_balance",
        "destination_balance_type": "available_balance",
        "currency_code": "USD",
        "amount": 10
    }
}

In this section:

Documentation