--- title: "Delete Wallet Contact" source_url: https://docs.rapyd.net/en/delete-wallet-contact.html lang: en --- # Delete Wallet Contact Delete a personal contact from a company wallet or client wallet. > **Note:** > > The code samples include successful requests (200), bad requests (400), and an unauthorized request (401). > > For a list of all error messages that appear due to bad requests, see: > > - [Wallet Contact Errors](https://docs.rapyd.net/en/wallet-contact-errors.md "Wallet Contact Errors") > - [Wallet Errors](https://docs.rapyd.net/en/wallet-errors.md "Wallet Errors") > - [General Errors](https://docs.rapyd.net/en/general-errors.md "General Errors") ### Parameters ### Request Path Parameters - - contact - ID of the contact. String starting with the prefix **cont_**. - - wallet - ID of the Rapyd Wallet that this contact is associated with. String starting with **ewallet_**. ### Request Header Parameters - - access_key - Unique access key provided by Rapyd for each authorized user. See [Developers](https://docs.rapyd.net/en/developers.md "Developers"). - - Content-Type - Indicates that the data appears in JSON format. Set to **application/json**. - - salt - Random string. Recommended length: 8-16 characters. - - signature - Signature calculated for each request individually. See [Request Signatures](https://docs.rapyd.net/en/request-signatures.md "Request Signatures"). - - timestamp - Timestamp for the request, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time") (seconds). ### Response Parameters - - address - Address of this contact person. Required when the client issues a card to the contact. This can be an 'address' object or the ID of an address object. For more information about the fields of the 'address' object, see [Create Address](https://docs.rapyd.net/en/create-address.md "Create Address"). - - authorized_user_details - Contains the authorized signatory information for the wallet business contact. This object is only relevant to **business** contacts and returns `null` when not applicable. - - country - The two-letter ISO 3166-1 ALPHA-2 country code of the authorized user. - - date_of_birth - Date of birth of the authorized user. Format: **YYYY-MM-DD** - - first_name - First name of the authorized user. - - last_name - Last name of the authorized user. - - business_details - Describes additional information for business entities. Required when `type` is **company**. - - address - Principal address of the business. See [Create Address](https://docs.rapyd.net/en/create-address.md "Create Address"). - - annual_revenue - Annual revenue of the business in US dollars. Maximum value: 100000000000000. Decimal. - - cnae_code - Business activity code of the business, according to the Classificação Nacional de Atividades Econômicas of Brazil. Alphanumeric string. Maximum 7 characters. - - created_at - Time of creation of the `business_details` object, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time"). - - customer_service_phone_number - Phone number for contacting the customer support service of the sub-merchant business,  in E.164 format. Relevant to Payment Facilitator (PayFac). - - entity_type - Type of business entity. One of the following: - **sole_prop** - Sole proprietorship. - **partnership** - Partnership. - **company** - Company. - **government** - Government agency. - **charity** - Charity. - **NPO** - Non-profit organization. - **association** - Unincorporated business association. - **trust** - Trust. - - establishment_date - Date that the business was established. Format: **YYYY-MM-DD**. - - id - ID of the `business_details` object. String starting with **busi_**. - - industry_category - Name of the industry that this business belongs to. Alphanumeric string with no special characters. - - industry_sub_category - Subcategory of the industry that this business belongs to. - - legal_entity_type - Type of legal entity. Alphanumeric string. - - mcc - Four-digit merchant category code (MCC) of the sub-merchant business, as defined in [ISO 18245](https://www.iso.org/standard/79450.html). Relevant to Payment Facilitator (PayFac). - - name - Business name. - - registration_number - Registration number. - - statement_descriptor - The sub-merchant name or business name.. Relevant to Payment Facilitator (PayFac). - - tax_id - The merchant’s company tax identifier. - - website_url - URL of the sub-merchant business website. Relevant to Payment Facilitator (PayFac). - - compliance_profile - Indicates the degree to which this contact can use the wallet. One of the following: - **1** - All transactions are allowed. - **0** - The wallet is limited, and the contact must complete the identity verification process. - **-1** - The wallet is restricted and cannot be used for any transactions. - - contact_reference_id - ID of a wallet contact, defined by the customer or end user. Must be unique. String. Cannot start with **cont_**. - - contact_type - Type of contact. One of the following: - **personal** - An individual customer. - **business** - A business customer. - - country - The two-letter ISO 3166-1 ALPHA-2 code for the country. To determine the code for a country, see [List Countries](https://docs.rapyd.net/en/list-countries.md "List Countries"). - - created_at - Time of creation of the `contact` object, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time"). - - date_of_birth - Date of birth of the individual. Format: **YYYY-MM-DD** - - email - Email address of the contact. - - ewallet - ID of the Rapyd Wallet that this contact is associated with. String starting with **ewallet_**. - - first_name - First name of the personal contact or primary person associated with the business contact. For a **personal** contact type, alphabetic characters and spaces. - - gender - Gender of the personal contact or primary person associated with the business contact. One of the following values: - **male** - **female** - **other** - **not_applicable** - - house_type - Description of the type of residency at the contact's residence. One of the following values: - **lease** - A long-term lease. - **live_with_family** - The contact lives with family. - **own** - The contact owns the residence. - **owner** - The contact is the owner of the residence. - **month_to_month** - An informal agreement, renewable each month. - **housing_project** - A room in a large residence facility, such as a residence hall or senior citizens' home. - - id - ID of the `contact` object. String starting with **cont_**. - - identification_number - ID number as shown by the ID document. - - identification_type - Type of the identification document associated with the contact. For types that are valid in the country, use [List Official Identification Documents](https://docs.rapyd.net/en/list-official-identification-documents.md "List Official Identification Documents"). - - issued_card_data - Describes additional information about the business contact for a company wallet. - - preferred_name - The name of the contact person. - - transaction_permissions - Indicates permissions for issuing transactions. Possible values: - **allowed** - **not_allowed** - - role_in_company - The role of the named person. One of the following values: - **owner** - Sole proprietor or partner. - **agent** - Authorized agent or attorney in fact. - **employee** - Authorized employee. - - last_name - Family name of the personal contact or primary person associated with the business contact. For a **personal** contact type, alphabetic characters and spaces. Required for issuing a card to a personal contact. - - marital_status - Marital status of the personal contact or primary person associated with the business contact. One of the following values: - **married** - **single** - **divorced** - **widowed** - **cohabiting** - **not_applicable** - - metadata - A JSON object defined by the client. See [Metadata](https://docs.rapyd.net/en/metadata.md "Metadata"). - - middle_name - Middle name of the personal contact or primary person associated with the business contact. - - mothers_name - Name of the mother of the personal contact or primary person associated with the business contact. Alphabetic characters and spaces. - - nationality - The citizenship of the contact. Two-letter ISO 3166-1 ALPHA-2 code for the country. To determine the code for a country, see [List Countries](https://docs.rapyd.net/en/list-countries.md "List Countries"). - - phone_number - Phone number of the contact in E.164 format. - - second_last_name - Second last name of the personal contact or primary person associated with the business contact. - - send_notifications - Determines whether Rapyd sends notifications to the contact. Default is **false**. - - 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. ### Code Samples - - .NET - ```csharp using System; namespace RapydApiRequestSample { class Program { static void Main(string[] args) { try { string wallet = "ewallet_5d228399661dac92968ace74f7aa00c6"; string contact = "cont_78cb81b4ef7e079d0a95445e15e820fd"; string result = RapydApiRequestSample.Utilities.MakeRequest("DELETE", $"/v1/ewallets/{wallet}/contacts/{contact}"); Console.WriteLine(result); } catch (Exception e) { Console.WriteLine("Error completing request: " + e.Message); } } } } ``` - - JavaScript - ```javascript const makeRequest = require('/utilities').makeRequest; async function main() { try { const result = await makeRequest( 'DELETE', '/v1/ewallets/ewallets/ewallet_5d228399661dac92968ace74f7aa00c6/contacts/cont_78cb81b4ef7e079d0a95445e15e820fd' ); console.log(result); } catch (error) { console.error('Error completing request', error); } } ``` - - PHP - ```php /utilities.php"; include($path); try { $object = make_request('delete', '/v1/ewallets/ewallet_5d228399661dac92968ace74f7aa00c6/contacts/cont_78cb81b4ef7e079d0a95445e15e820fd'); var_dump($object); } catch(Exception $e) { echo "Error: $e"; } ?> ``` - - Python - ```python from pprint import pprint from utilities import make_request wallet = 'ewallet_5d228399661dac92968ace74f7aa00c6' contact = 'cont_78cb81b4ef7e079d0a95445e15e820fd' results = make_request(method='delete', path=f'/v1/ewallets/{wallet}/contacts/{contact}') pprint(results) ``` - /v1/ewallets/:wallet/contacts/:contact - Delete Wallet Contact - ```curl curl -X delete 'https://sandboxapi.rapyd.net/v1/ewallets/ewallet_b5320c566cc4aa01fe77440ad08693f7/contacts/cont_614c5bc028d59709202f09e601642352' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "121a8c9a-bf63-484a-a2ab-42d231da9297" }, "data": { "id": "cont_614c5bc028d59709202f09e601642352", "delete": true } } ``` - Bad Request - Cannot Delete the Only Contact (Personal Wallet) - ```curl curl -X delete 'https://sandboxapi.rapyd.net/v1/ewallets/ewallet_26a33b99ebba47f673dcbdf18889ac46/contacts/cont_539d2d5976d11011a7fc4b7969b55264' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' ``` - ```json { "status": { "error_code": "ERROR_DELETE_CONTACT_FROM_PERSONAL_EWALLET", "status": "ERROR", "message": "The request tried to delete a contact, but the wallet was a personal wallet. A personal wallet can have only one contact and it cannot be deleted. The request was rejected. Corrective action: None. Determine why an attempt was made to delete the contact.", "response_code": "ERROR_DELETE_CONTACT_FROM_PERSONAL_EWALLET", "operation_id": "79eb406d-cdc0-4388-838e-c617d25227c6" } } ``` - Bad Request - Wallet Contact Not Found - ```curl curl -X delete 'https://sandboxapi.rapyd.net/v1/ewallets/ewallet_82dd0417a86aebb564da2f96936ce2d2/contacts/cont_91a70854acf4b78ddbbf767d2e4c0cf3' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' ``` - ```json { "status": { "error_code": "ERROR_GET_EWALLET_CONTACT", "status": "ERROR", "message": "The request attempted an operation that requires a wallet contact, but the contact was not found. The request was rejected. Corrective action: In the path, specify the ID of a valid wallet, a string starting with 'ewallet_', and the ID of a valid contact belonging to that wallet, a string starting with 'cont_'.", "response_code": "ERROR_GET_EWALLET_CONTACT", "operation_id": "b5ca7c06-e330-4a14-9b5b-6781936b669c" } } ``` - Unauthorized - ```curl curl -X delete 'https://sandboxapi.rapyd.net/v1/ewallets/ewallet_62f756c384f52bb2aaf7f6a05da36b9f/contacts/cont_91a70854acf4b78ddbbf767d2e4c0cf3' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' ``` - ```json { "status": { "error_code": "UNAUTHENTICATED_API_CALL", "status": "ERROR", "message": "The request was rejected due to an authentication issue. Corrective action: Check the status of your account in the 'Account Details' page of the Client Portal.", "response_code": "UNAUTHENTICATED_API_CALL", "operation_id": "b877da07-5b89-4574-aa7c-90d0c2fca0ea" } } ```