Skip to main content

Documentation

Set Wallet Account Limit

Set the maximum balance limit or the minimum balance threshold for an existing wallet account.

Note

  • The request must specify the account_id or the currency.

  • This endpoint replaces the deprecated endpoint: POST /v1/user/:wallet/account/limits

    Rapyd will continue to support the deprecated endpoint until December 31, 2024.

Related Information

    • wallet

    • Rapyd Wallet ID.

    • account_id

    • The ID of the account within the wallet. UUID.

    • amount

    • The amount of the limit.

    • currency

    • Three-letter ISO 4217 code for the currency of an existing account.

    • type

    • The limit type. One of the following values:

      • min_balance_threshold - The amount that triggers an email notification to increase the amount in the reserve balance.

      • max_balance_limit - The maximum balance that this account can hold.

  • /v1/ewallets/:ewallet/account/limits

  • Set Wallet Account Limit

  • curl --location 'https://sandboxapi.rapyd.net/v1/ewallets/ewallet_f86e34cfde1aa06dc0468d98b593a7f2/account/limits' \
    -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'--header 'Content-Type: application/json' \
    -d'{
        "currency": "USD",
        "amount": 12000,
        "type": "max_balance_limit",
        "account_id": "5221e6b8-ed4d-47f6-80c4-3c757f00ce26"
    }
    '
    
  • {
        "status": {
            "error_code": "",
            "status": "SUCCESS",
            "message": "",
            "response_code": "",
            "operation_id": "449a0c54-1f89-4191-aea4-11c2dccd46a1"
        },
        "data": [
            {
                "id": "5221e6b8-ed4d-47f6-80c4-3c757f00ce26",
                "currency": "USD",
                "alias": "USD",
                "balance": 99999,
                "received_balance": 0,
                "on_hold_balance": 0,
                "reserve_balance": 0,
                "limits": [
                    {
                        "type": "max_balance_limit",
                        "amount": 12000,
                        "currency": "USD",
                        "updated_at": 1704364699
                    }
                ],
                "limit": "12000.00000"
            }
        ]
    }