Change Wallet Status

Disable, enable, or close a Rapyd Wallet.

This method triggers the Wallet Status Changed Webhook.

In addition, disabling a wallet triggers the Wallet Disabled Webhook, enabling a wallet triggers the Wallet Enabled Webhook, and closing a wallet triggers the Wallet Closed Webhook.

The webhooks contain the same information as the response.

Disable a wallet to prevent the following actions:

Moving money into or out of the wallet.
Issuing a bank account number or card to the wallet.

Disable a wallet when the customer requests it, or while you conduct an investigation.

Disabling a wallet changes the status of the wallet to DIS (disabled).

Enable a wallet to reverse the process.

Enabling a wallet changes the status of the wallet to ACT (enabled and active).

Close a wallet to permanently disable it. The wallet must have no balances, no pending transactions, and no open virtual accounts.

Closing a wallet changes the status of the wallet to CLO (permanently closed). You cannot change the status of a closed wallet.

Parameters

Request Path Parameters

- ewallet
- ID of the Rapyd Wallet. String starting with ewallet_.
- status
- The change to make in the wallet status. One of the following:
  - close - Change the status from enabled and active (ACT) or disabled (DIS) to permanently closed (CLO).
  - disable - Change the status from enabled and active (ACT) to disabled (DIS).
  - enable - Change the status from disabled (DIS) to enabled and active (ACT).

Request Header Parameters

Response Parameters

- accounts
- An array of objects with the following fields:
  alias
  Alternate text description of the currency.
  balance
  Available funds in the account.
  currency
  Three-letter ISO 4217 code for the currency used in the balance field.
  id
  ID of the account. UUID.
  limit
  Reserved.
  limits
  Reserved.
  on_hold_balance
  Amount in the on-hold balance of the account.
  received_balance
  Amount of escrow funds in the account.
  reserve_balance
  Amount in the reserve balance of the account.
- category
- Indicates the type of client wallet. One of the following:
  - collect
  - disburse
  - card_authorization
  - general
- cnls_partner_query_reference
- Value of the partner_query_reference parameter used as the query request ID in the Card Network Lookup Service (CNLS). See Retrieve Query Results. Relevant to Payment Facilitator (PayFac).
- contacts
- Contains the following fields:
  - data
    An array of 'contact' objects. For details about the fields of the 'contact' object, see Add Contact to Wallet.
  - has_more
    Indicates whether there are more contacts than appear in the data array.
  - total_count
    The total number of contacts in the wallet.
  - url
    URL to retrieve all contacts in the wallet. Use HTTP get.
- email
- Email address of the wallet owner. Deprecated. The email address belongs to the contact.
- ewallet_reference_id
- Wallet ID defined by the customer or end user.
- first_name
- First name of the wallet owner.
- id
- Unique identifier of the wallet object. String starting with ewallet_.
- last_name
- Family name of the wallet owner.
- metadata
- A JSON object defined by the client. See Metadata.
- parent_ewallet
- ID of the parent wallet. String starting with ewallet_.
- phone_number
- Phone number of the wallet owner in E.164 format. Deprecated. The phone number belongs to the contact.
- status
- Status of the wallet. One of the following:
  - ACT - Enabled and active.
  - CLO - Permanently closed.
  - DIS - Disabled.
- type
- Type of wallet. One of the following:
  - company - A business wallet.
  - person - The wallet of an individual consumer.
  - client - A wallet for the Rapyd client. To create additional wallets of this type, contact Client Support.
- verification_status
- Result of the verification check. One of the following:
  - not verified - The contact has not been submitted for the Know Your Customer checks.
  - KYCd - The user has passed the Know Your Customer checks.

/v1/user/ewallets/:ewallet/statuses/:status

Disable Wallet

curl -X post
https://sandboxapi.rapyd.net/v1/ewallets/ewallet_df9de1b6310514f9c11a3f52dddd9ca4/statuses/disable
-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'

{
    "status": {
        "error_code": "",
        "status": "SUCCESS",
        "message": "",
        "response_code": "",
        "operation_id": "450987de-f91f-4f9b-86f7-a577905c4a90"
    },
    "data": {
        "phone_number": "+17560705621",
        "email": null,
        "first_name": "Fred",
        "last_name": "Cooks",
        "id": "ewallet_df9de1b6310514f9c11a3f52dddd9ca4",
        "status": "DIS",
        "accounts": [
            {
                "id": "4da1dfcd-2cce-11eb-9403-124eb1b705c1",
                "currency": "EUR",
                "alias": "EUR",
                "balance": 10,
                "received_balance": 0,
                "on_hold_balance": 0,
                "reserve_balance": 0,
                "limits": null,
                "limit": null
            }
        ],
        "verification_status": "not verified",
        "type": "person",
        "metadata": {},
        "ewallet_reference_id": null,
        "category": null,
        "contacts": null,
        "parent_ewallet": null,
        "cnls_partner_query_reference": null
    }
}

Enable Wallet

curl -X post
https://sandboxapi.rapyd.net/v1/ewallets/ewallet_df9de1b6310514f9c11a3f52dddd9ca4/statuses/enable
-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'

{
    "status": {
        "error_code": "",
        "status": "SUCCESS",
        "message": "",
        "response_code": "",
        "operation_id": "fef01a0c-2e30-4362-880f-b220904a9613"
    },
    "data": {
        "phone_number": "+17560705621",
        "email": null,
        "first_name": "Fred",
        "last_name": "Cooks",
        "id": "ewallet_df9de1b6310514f9c11a3f52dddd9ca4",
        "status": "ACT",
        "accounts": [
            {
                "id": "4da1dfcd-2cce-11eb-9403-124eb1b705c1",
                "currency": "EUR",
                "alias": "EUR",
                "balance": 10,
                "received_balance": 0,
                "on_hold_balance": 0,
                "reserve_balance": 0,
                "limits": null,
                "limit": null
            }
        ],
        "verification_status": "not verified",
        "type": "person",
        "metadata": {},
        "ewallet_reference_id": null,
        "category": null,
        "contacts": null,
        "parent_ewallet": null,
        "cnls_partner_query_reference": null
    }
}

Close Wallet

curl -X post
https://sandboxapi.rapyd.net/v1/ewallets/ewallet_67b83dcb34c274156da8607ab2abca4b/statuses/close
-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'

{
    "status": {
        "error_code": "",
        "status": "SUCCESS",
        "message": "",
        "response_code": "",
        "operation_id": "90031402-1b78-4930-b929-b4e9f7211dec"
    },
    "data": {
        "phone_number": null,
        "email": null,
        "first_name": "John",
        "last_name": "Doe",
        "id": "ewallet_50423d7d42dde39a661e451fedc968ea",
        "status": "CLO",
        "accounts": [],
        "verification_status": "not verified",
        "type": "person",
        "metadata": {},
        "ewallet_reference_id": "2025-07-22a",
        "category": null,
        "contacts": null,
        "parent_ewallet": "ewallet_c1943cfeda5f98247ab117e5d2648861",
        "cnls_partner_query_reference": null
    }
}

In this section:

Documentation

Change Wallet Status

Parameters

Request Path Parameters

Request Header Parameters

Response Parameters

Search results