Update Wallet
Change or modify a Rapyd Wallet.
Note
This endpoint replaces the deprecated endpoint:
put /v1/userRapyd no longer supports the deprecated endpoint.
The code samples include successful requests (200) and bad requests (400).
For error messages that appear due to bad requests (400), see:
For information about unauthorized request (401) and other authentication errors, see Troubleshooting Authentication and Authorization Errors.
ewallet
ID of the Rapyd Wallet. String starting with ewallet_.
cnls_partner_query_reference
Payment Facilitator (PayFac) only. Value of the
partner_query_referenceparameter used as the query request ID in the Card Network Lookup Service (CNLS). See Retrieve Query Results.
ewallet_reference_id
Rapyd Wallet ID defined by the customer or end user. Must be unique.
first_name
First name of the Rapyd Wallet owner. For a person wallet type, alphabetic characters and spaces.
last_name
Family name of the Rapyd Wallet owner. For a person wallet type, alphabetic characters and spaces.
.NET
using System; using System.Text.Json; namespace RapydApiRequestSample { class Program { static void Main(string[] args) { try { var metadata = new { merchant_defined = "updated" }; var requestObj = new { ewallet = "ewallet_72b4ff39ca50dccc73c0ee65d85e124e", ewallet_reference_id = "4-star-pro-02212021", metadata, }; string request = JsonSerializer.Serialize(requestObj); string result = RapydApiRequestSample.Utilities.MakeRequest("PUT", "/v1/user", request); Console.WriteLine(result); } catch (Exception e) { Console.WriteLine("Error completing request: " + e.Message); } } } }
JavaScript
const makeRequest = require('<path-to-your-utility-file>/utilities').makeRequest; async function main() { try { const body = { ewallet: 'ewallet_72b4ff39ca50dccc73c0ee65d85e124e', ewallet_reference_id: '4-star-pro-02212021', metadata: { merchant_defined: 'updated' } }; const result = await makeRequest('PUT', '/v1/user', body); console.log(result); } catch (error) { console.error('Error completing request', error); } }
PHP
<?php $path = $_SERVER['DOCUMENT_ROOT']; $path .= "/<path-to-your-utility-file>/utilities.php"; include($path); $body = [ 'ewallet' => 'ewallet_72b4ff39ca50dccc73c0ee65d85e124e', 'ewallet_reference_id' => '4-star-pro-02212021', 'metadata' => [ 'merchant_defined' => "updated" ] ]; try { $object = make_request('put', '/v1/user', $body); var_dump($object); } catch(Exception $e) { echo "Error: $e"; } ?>
Python
from pprint import pprint from utilities import make_request body = { "ewallet": "ewallet_72b4ff39ca50dccc73c0ee65d85e124e", "ewallet_reference_id": "4-star-pro-02212021", "metadata": { "merchant_defined": "updated" } } results = make_request(method='put', path='/v1/user', body=body) pprint(results)
/v1/ewallets/:ewallet
Update cnls_partner_query_reference - PayFac
curl -X post 'https://sandboxapi.rapyd.net/v1/ewallets/ewallet_b5320c566cc4aa01fe77440ad08693f7' \ -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' \ --data-raw '{ "cnls_partner_query_reference": "abcd123" }'{ "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "f9a3368f-3dbf-49c6-a81a-a17f5150612c" }, "data": { "phone_number": null, "email": "john.doe.162417@example.com", "first_name": "John", "last_name": "Doe", "id": "ewallet_b5320c566cc4aa01fe77440ad08693f7", "status": "ACT", "accounts": [ { "id": "ff97f975-5e85-4df0-8f01-9b1b051d3e39", "currency": "PLN", "alias": "PLN", "balance": 10000, "received_balance": 0, "on_hold_balance": 0, "reserve_balance": 0, "limits": null, "limit": null }, { "id": "4a659c50-3f2d-487a-b062-30459e00c437", "currency": "EUR", "alias": "EUR", "balance": 9798, "received_balance": 0, "on_hold_balance": 0, "reserve_balance": 0, "limits": null, "limit": null } ], "verification_status": "not verified", "type": "company", "metadata": { "merchant_defined": true }, "ewallet_reference_id": "erd-2025-08-10a", "category": null, "contacts": { "data": [ { "id": "cont_18c0d881a3d0d2e9e54d4664c6b0022d", "first_name": "John", "last_name": "Doe", "middle_name": "", "second_last_name": "", "gender": "not_applicable", "marital_status": "not_applicable", "house_type": "", "contact_type": "business", "phone_number": "+14155551234", "email": "john.doe.162417@example.com", "identification_type": "", "identification_number": "", "issued_card_data": { "preferred_name": "", "transaction_permissions": "", "role_in_company": "" }, "date_of_birth": null, "country": "US", "nationality": null, "address": null, "ewallet": "ewallet_b5320c566cc4aa01fe77440ad08693f7", "created_at": 1753881858, "metadata": {}, "business_details": { "id": "busi_aba4330005786f053d25c46168d21fc4", "name": "", "registration_number": "", "entity_type": "n/a", "industry_category": "n/a", "industry_sub_category": "n/a", "address": { "id": "address_3c15646a8e2011f884c92eb416f52a02", "name": "John Doe", "line_1": "789 Main Street", "line_2": "Apt 4E", "line_3": "", "city": "Anytown", "state": "", "country": "US", "zip": "54321", "phone_number": "+14155555555", "metadata": {}, "canton": "", "district": "", "created_at": 1755781052 }, "created_at": 1753881858, "annual_revenue": 0, "establishment_date": null, "legal_entity_type": null, "cnae_code": null, "statement_descriptor": null, "mcc": null, "website_url": null, "customer_service_phone_number": null }, "compliance_profile": 0, "verification_status": "not verified", "send_notifications": false, "mothers_name": "", "contact_reference_id": null }, { "id": "cont_6b37bac42846c7046bdb9e24b89a5d05", "first_name": "Jane", "last_name": "Doe", "middle_name": "", "second_last_name": "", "gender": "not_applicable", "marital_status": "not_applicable", "house_type": "", "contact_type": "personal", "phone_number": "", "email": "", "identification_type": "PA", "identification_number": "1233242424", "issued_card_data": { "preferred_name": "", "transaction_permissions": "", "role_in_company": "" }, "date_of_birth": null, "country": "US", "nationality": null, "address": { "id": "address_2c98c788eafe3a5a6b7541431e0ced5e", "name": "Jane Doe", "line_1": "123 Lake Forest Drive", "line_2": "", "line_3": "", "city": "Anytown", "state": "NY", "country": "", "zip": "12345", "phone_number": "+14155551234", "metadata": { "merchant_defined": true }, "canton": "", "district": "", "created_at": 1754572956 }, "ewallet": "ewallet_b5320c566cc4aa01fe77440ad08693f7", "created_at": 1754572956, "metadata": {}, "business_details": null, "compliance_profile": 0, "verification_status": "not verified", "send_notifications": false, "mothers_name": "", "contact_reference_id": null }, { "id": "cont_1efdd747f4495c054be799227448ef6b", "first_name": "Jane", "last_name": "Doe", "middle_name": "", "second_last_name": "", "gender": "not_applicable", "marital_status": "not_applicable", "house_type": "", "contact_type": "personal", "phone_number": "", "email": "", "identification_type": "PA", "identification_number": "1233242424", "issued_card_data": { "preferred_name": "", "transaction_permissions": "", "role_in_company": "" }, "date_of_birth": null, "country": "US", "nationality": null, "address": { "id": "address_2827aa908f199b14067f2311180bdde9", "name": "Jane Doe", "line_1": "123 Lake Forest Drive", "line_2": "", "line_3": "", "city": "Anytown", "state": "NY", "country": "", "zip": "12345", "phone_number": "+14155551234", "metadata": {}, "canton": "", "district": "", "created_at": 1757241207 }, "ewallet": "ewallet_b5320c566cc4aa01fe77440ad08693f7", "created_at": 1757241207, "metadata": {}, "business_details": null, "compliance_profile": 0, "verification_status": "not verified", "send_notifications": false, "mothers_name": "", "contact_reference_id": null } ], "has_more": true, "total_count": 6, "url": "/v1/ewallets/ewallet_b5320c566cc4aa01fe77440ad08693f7/contacts" }, "parent_ewallet": null, "cnls_partner_query_reference": null } }
Update Wallet - Reference ID
curl -X post 'https://sandboxapi.rapyd.net/v1/ewallets/ewallet_df9de1b6310514f9c11a3f52dddd9ca4' \ -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' \ --data-raw '{ "ewallet_reference_id": "2025-09-10a" }'{ "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "3de8882a-a6bf-47ed-92ba-0e8f5d4eb5a5" }, "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": { "data": [ { "id": "cont_e21a199b8cfe5ac7c9b220fa9d4039bf", "first_name": "Fred", "last_name": "Cooks", "middle_name": "", "second_last_name": "", "gender": "not_applicable", "marital_status": "not_applicable", "house_type": "", "contact_type": "personal", "phone_number": "+17560705621", "email": "", "identification_type": "", "identification_number": "", "issued_card_data": { "preferred_name": "", "transaction_permissions": "", "role_in_company": "" }, "date_of_birth": null, "country": "", "nationality": null, "address": null, "ewallet": "ewallet_df9de1b6310514f9c11a3f52dddd9ca4", "created_at": 1606055013, "metadata": {}, "business_details": null, "compliance_profile": 0, "verification_status": "not verified", "send_notifications": false, "mothers_name": "", "contact_reference_id": null } ], "has_more": false, "total_count": 1, "url": "/v1/ewallets/ewallet_df9de1b6310514f9c11a3f52dddd9ca4/contacts" }, "parent_ewallet": null, "cnls_partner_query_reference": null } }
Update Wallet - Associated Parent Wallet
curl -X post 'https://sandboxapi.rapyd.net/v1/ewallets/ewallet_31fb2dbbaf6519461ee4fbe1062220d3' \ -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' \ --data-raw '{ "parent_ewallet": "ewallet_b5320c566cc4aa01fe77440ad08693f7" }'{ "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "ce016636-74f4-4c19-b3e8-83080b19aa4b" }, "data": { "phone_number": null, "email": "jane.smith.162417@example.com", "first_name": "Jane", "last_name": "Smith", "id": "ewallet_31fb2dbbaf6519461ee4fbe1062220d3", "status": "ACT", "accounts": [ { "id": "49b2c1db-dd26-444f-8667-5508ae901de5", "currency": "EUR", "alias": "EUR", "balance": 101, "received_balance": 0, "on_hold_balance": 0, "reserve_balance": 0, "limits": null, "limit": null }, { "id": "d722c12f-e88f-47b8-a2a1-96606b0ee997", "currency": "HKD", "alias": "HKD", "balance": 130356.1, "received_balance": 0, "on_hold_balance": 0, "reserve_balance": 0, "limits": null, "limit": null } ], "verification_status": "not verified", "type": "person", "metadata": { "merchant_defined": true }, "ewallet_reference_id": "erd-2025-08-10b", "category": null, "contacts": { "data": [ { "id": "cont_cfcecbbaf6bd086f7077a70f53b8e259", "first_name": "Jane", "last_name": "Smith", "middle_name": "", "second_last_name": "", "gender": "not_applicable", "marital_status": "not_applicable", "house_type": "", "contact_type": "personal", "phone_number": "+14155551235", "email": "jane.smith.162417@example.com", "identification_type": "", "identification_number": "", "issued_card_data": { "preferred_name": "", "transaction_permissions": "", "role_in_company": "" }, "date_of_birth": null, "country": "US", "nationality": null, "address": null, "ewallet": "ewallet_31fb2dbbaf6519461ee4fbe1062220d3", "created_at": 1753881859, "metadata": {}, "business_details": null, "compliance_profile": 0, "verification_status": "not verified", "send_notifications": false, "mothers_name": "", "contact_reference_id": null } ], "has_more": false, "total_count": 1, "url": "/v1/ewallets/ewallet_31fb2dbbaf6519461ee4fbe1062220d3/contacts" }, "parent_ewallet": "ewallet_b5320c566cc4aa01fe77440ad08693f7", "cnls_partner_query_reference": null } }
Update Wallet - Metadata
curl -X post 'https://sandboxapi.rapyd.net/v1/ewallets/ewallet_b5320c566cc4aa01fe77440ad08693f7' \ -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' \ --data-raw '{ "email": "johndoe@rapyd.net", "metadata": { "merchant_defined": "updated" } }'{ "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "b3c23ad7-4923-4634-b977-286ce7adc904" }, "data": { "phone_number": null, "email": "johndoe@rapyd.net", "first_name": "John", "last_name": "Doe", "id": "ewallet_b5320c566cc4aa01fe77440ad08693f7", "status": "ACT", "accounts": [ { "id": "ff97f975-5e85-4df0-8f01-9b1b051d3e39", "currency": "PLN", "alias": "PLN", "balance": 10000, "received_balance": 0, "on_hold_balance": 0, "reserve_balance": 0, "limits": null, "limit": null }, { "id": "4a659c50-3f2d-487a-b062-30459e00c437", "currency": "EUR", "alias": "EUR", "balance": 9808, "received_balance": 0, "on_hold_balance": 0, "reserve_balance": 0, "limits": null, "limit": null }, { "id": "8dc23d06-198d-4673-85af-2675f0af4518", "currency": "USD", "alias": "USD", "balance": 200, "received_balance": 0, "on_hold_balance": 0, "reserve_balance": 0, "limits": null, "limit": null }, { "id": "29c1889a-572c-4200-b669-6c0144a9e758", "currency": "GBP", "alias": "GBP", "balance": 800, "received_balance": 0, "on_hold_balance": 0, "reserve_balance": 0, "limits": null, "limit": null } ], "verification_status": "not verified", "type": "company", "metadata": { "merchant_defined": "updated" }, "ewallet_reference_id": "2025-09-10a", "category": null, "contacts": { "data": [ { "id": "cont_18c0d881a3d0d2e9e54d4664c6b0022d", "first_name": "John", "last_name": "Doe", "middle_name": "", "second_last_name": "", "gender": "not_applicable", "marital_status": "not_applicable", "house_type": "", "contact_type": "business", "phone_number": "+14155551234", "email": "john.doe.162417@example.com", "identification_type": "", "identification_number": "", "issued_card_data": { "preferred_name": "", "transaction_permissions": "", "role_in_company": "" }, "date_of_birth": null, "country": "US", "nationality": null, "address": null, "ewallet": "ewallet_b5320c566cc4aa01fe77440ad08693f7", "created_at": 1753881858, "metadata": {}, "business_details": { "id": "busi_aba4330005786f053d25c46168d21fc4", "name": "", "registration_number": "", "entity_type": "n/a", "industry_category": "n/a", "industry_sub_category": "n/a", "address": { "id": "address_3c15646a8e2011f884c92eb416f52a02", "name": "John Doe", "line_1": "789 Second Street", "line_2": "Apt 4E", "line_3": "", "city": "Anytown", "state": "", "country": "US", "zip": "54321", "phone_number": "+14155555555", "metadata": {}, "canton": "", "district": "", "created_at": 1755781052 }, "created_at": 1753881858, "annual_revenue": 0, "establishment_date": null, "legal_entity_type": null, "cnae_code": null, "statement_descriptor": null, "mcc": null, "website_url": null, "customer_service_phone_number": null }, "compliance_profile": 0, "verification_status": "not verified", "send_notifications": false, "mothers_name": "", "contact_reference_id": null }, { "id": "cont_6b37bac42846c7046bdb9e24b89a5d05", "first_name": "Jane", "last_name": "Doe", "middle_name": "", "second_last_name": "", "gender": "not_applicable", "marital_status": "not_applicable", "house_type": "", "contact_type": "personal", "phone_number": "+14155551997", "email": "", "identification_type": "PA", "identification_number": "1233242424", "issued_card_data": { "preferred_name": "", "transaction_permissions": "", "role_in_company": "" }, "date_of_birth": null, "country": "US", "nationality": null, "address": { "id": "address_2c98c788eafe3a5a6b7541431e0ced5e", "name": "Jane Doe", "line_1": "123 Lake Forest Drive", "line_2": "", "line_3": "", "city": "Anytown", "state": "NY", "country": "", "zip": "12345", "phone_number": "+14155551234", "metadata": { "merchant_defined": true }, "canton": "", "district": "", "created_at": 1754572956 }, "ewallet": "ewallet_b5320c566cc4aa01fe77440ad08693f7", "created_at": 1754572956, "metadata": { "merchant_defined": "updated" }, "business_details": null, "compliance_profile": 0, "verification_status": "not verified", "send_notifications": false, "mothers_name": "", "contact_reference_id": "johndoe2025-11-03a" }, { "id": "cont_1efdd747f4495c054be799227448ef6b", "first_name": "Jane", "last_name": "Doe", "middle_name": "", "second_last_name": "", "gender": "not_applicable", "marital_status": "not_applicable", "house_type": "", "contact_type": "personal", "phone_number": "", "email": "", "identification_type": "PA", "identification_number": "1233242424", "issued_card_data": { "preferred_name": "", "transaction_permissions": "", "role_in_company": "" }, "date_of_birth": null, "country": "US", "nationality": null, "address": { "id": "address_2827aa908f199b14067f2311180bdde9", "name": "Jane Doe", "line_1": "123 Lake Forest Drive", "line_2": "", "line_3": "", "city": "Anytown", "state": "NY", "country": "", "zip": "12345", "phone_number": "+14155551234", "metadata": {}, "canton": "", "district": "", "created_at": 1757241207 }, "ewallet": "ewallet_b5320c566cc4aa01fe77440ad08693f7", "created_at": 1757241207, "metadata": {}, "business_details": null, "compliance_profile": 0, "verification_status": "not verified", "send_notifications": false, "mothers_name": "", "contact_reference_id": null } ], "has_more": true, "total_count": 9, "url": "/v1/ewallets/ewallet_b5320c566cc4aa01fe77440ad08693f7/contacts" }, "parent_ewallet": null, "cnls_partner_query_reference": null } }
Update Wallet - First & Last Name
curl -X post 'https://sandboxapi.rapyd.net/v1/ewallets/ewallet_b5320c566cc4aa01fe77440ad08693f7' \ -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' \ --data-raw '{ "last_name": "Doe", "first_name": "John" }'{ "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "bbe2280e-61ae-4f1e-9768-d10168389179" }, "data": { "phone_number": null, "email": "johndoe@rapyd.net", "first_name": "John", "last_name": "Doe", "id": "ewallet_b5320c566cc4aa01fe77440ad08693f7", "status": "DIS", "accounts": [ { "id": "ff97f975-5e85-4df0-8f01-9b1b051d3e39", "currency": "PLN", "alias": "PLN", "balance": 10000, "received_balance": 0, "on_hold_balance": 0, "reserve_balance": 0, "limits": null, "limit": null }, { "id": "4a659c50-3f2d-487a-b062-30459e00c437", "currency": "EUR", "alias": "EUR", "balance": 9808, "received_balance": 0, "on_hold_balance": 0, "reserve_balance": 0, "limits": null, "limit": null }, { "id": "8dc23d06-198d-4673-85af-2675f0af4518", "currency": "USD", "alias": "USD", "balance": 200, "received_balance": 0, "on_hold_balance": 0, "reserve_balance": 0, "limits": null, "limit": null }, { "id": "29c1889a-572c-4200-b669-6c0144a9e758", "currency": "GBP", "alias": "GBP", "balance": 800, "received_balance": 0, "on_hold_balance": 0, "reserve_balance": 0, "limits": null, "limit": null } ], "verification_status": "not verified", "type": "company", "metadata": { "merchant_defined": "updated" }, "ewallet_reference_id": "2025-09-10a", "category": null, "contacts": null, "parent_ewallet": null, "cnls_partner_query_reference": null } }
Bad Request - Invalid Wallet ID
curl -X post 'https://sandboxapi.rapyd.net/v1/ewallets/ewallet_123456789' \ -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' \ --data-raw '{ "metadata": { "merchant_defined": "updated data" } }'{ "status": { "error_code": "ERROR_GET_USER", "status": "ERROR", "message": "The request attempted an operation that requires a wallet, but the wallet was not found. The request was rejected. Corrective action: Use the ID of a valid wallet that has not been deleted. The ID is a string starting with 'ewallet_'.", "response_code": "ERROR_GET_USER", "operation_id": "7eeda170-73f7-4121-910b-1d45bf7104dd" } }
Bad Request - Reference ID Exists
curl -X post 'https://sandboxapi.rapyd.net/v1/ewallets/ewallet_b5320c566cc4aa01fe77440ad08693f7' \ -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' \ --data-raw '{ "ewallet_reference_id": "2025-09-10a" }'{ "status": { "error_code": "ERROR_UPDATE_USER_EWALLET_REFERENCE_ID_ALREADY_EXISTS", "status": "ERROR", "message": "The request tried to update a wallet, but the reference ID was already in use. The request was rejected. Corrective action: For 'ewallet_reference_id', enter a unique string.", "response_code": "ERROR_UPDATE_USER_EWALLET_REFERENCE_ID_ALREADY_EXISTS", "operation_id": "87227022-0413-4ffa-8aa9-0f4c05b573b1" } }