Put Funds on Hold

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

This action transfers funds from the available balance to the on-hold balance. If the wallet does not have enough funds in the available 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.

The customer cannot move funds that are on hold until the client releases the hold.

This method is relevant for person and company wallets.

Note

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

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/hold

Put Funds on Hold

curl -X post
https://sandboxapi.rapyd.net/v1/ewallets/accounts/balance/hold
-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": 22,
  "currency": "USD"
}
'

{
    "status": {
        "error_code": "",
        "status": "SUCCESS",
        "message": "",
        "response_code": "",
        "operation_id": "5dd7c271-c859-4060-9fad-f94b55ca1e42"
    },
    "data": {
        "id": "5f521c70-a1ae-45ec-9dcf-26cb810767ef",
        "source_transaction_id": "8e1fc8d9-4765-48a9-9a99-1d4309d08709",
        "destination_transaction_id": "394e249f-e6ae-4b5a-8745-127ab572d4fa",
        "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": "available_balance",
        "destination_balance_type": "on_hold_balance",
        "currency_code": "USD",
        "amount": 22
    }
}

In this section:

Documentation