# 5. Update

## **Update Wallet Owner Information**

<mark style="color:blue;">`PUT`</mark> `{{WalletUrl}}/api/v1/walletowner` &#x20;

{% hint style="info" %}
**Note:** Before calling this service, you must include the apikeypublic and apiclientpublic parameters in the Header section.

[<mark style="color:green;">**WalletAPI Address**</mark>](https://developer.paywall.one/payment-orchestration-integration-document/environment)
{% endhint %}

**The parameters that must be sent to the service are as follows:**

<table><thead><tr><th width="162">Parameter</th><th width="79">Type</th><th width="107">Required</th><th width="403">Description</th></tr></thead><tbody><tr><td>apikeypublic</td><td>string</td><td>Yes</td><td>It is the public key sent to authenticate the identity during API access. Security checks are performed based on this value.</td></tr><tr><td>apiclientpublic</td><td>string</td><td>Yes</td><td>It is the client key that identifies the requesting application. Used for authorizing API calls.</td></tr></tbody></table>

{% tabs %}
{% tab title="Service Request - JSON" %}

```json
{
  "Id": "0000-0000-0000-0000-0000",
  "Name": "{{$randomFullName}}",
  "Email": "{{$randomEmail}}",
  "PhoneNumber": "+905343664455",
  "Address": "{{$randomStreetAddress}}",
  "Country": "{{$randomCountry}}",
  "City": "{{$randomCity}}",
  "DateOfBirth": "2001-03-03",
  "CompanyName": "{{$randomCompanyName}}"
}
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Service Request - JSON" %}
{% code lineNumbers="true" %}

```json
{
    "Value": {
        "Id": "9ef565a2-5987-4da4-8b0e-f0b392196e7e",
        "Fullname": "yiğit",
        "Email": "Makenzie.Bins68@yahoo.com",
        "PhoneNumber": "+905343664456",
        "TaxNumber": "",
        "IdentityNumber": "68567422314",
        "OwnerType": "Individual",
        "CompanyName": "Schuster - Labadie",
        "Address": "57152 Koepp Prairie",
        "Country": "Senegal",
        "City": "Volkmanberg",
        "DateOfBirth": "2001-03-03",
        "MerchantId": 2071,
        "CreatedAt": "2025-04-22T12:40:20.724936Z",
        "UpdatedAt": "2025-04-22T12:41:09.1561171Z"
    },
    "Errors": [],
    "IsSuccess": true,
    "IsFailure": false
}
```

{% endcode %}
{% endtab %}
{% endtabs %}

## **Service Response**

<table><thead><tr><th width="192">Parameter</th><th width="147.89192708333331">Type</th><th>Description</th></tr></thead><tbody><tr><td>IsFailure</td><td>bool</td><td>Indicates whether there is an error in the service response. If true, it means the operation has failed. This should be considered during evaluation.</td></tr><tr><td>IsSuccess</td><td>bool</td><td>Indicates whether the operation was completed as expected. A true value signifies successful execution. It is used as a reference in result verification.</td></tr><tr><td>Errors</td><td>Array</td><td>Contains error information that occurred during the service call. Errors are typically presented with an error code and description. Used for troubleshooting.</td></tr><tr><td>Value</td><td>Array&#x3C;Items></td><td>Represents the core data content returned by the service. The results are transmitted to the user through this field. The return type may vary depending on the operation performed.</td></tr></tbody></table>

## **Service Response** (Value)

<table><thead><tr><th>Parameter</th><th>Type</th><th width="369.2421875">Description</th></tr></thead><tbody><tr><td>Id</td><td>Guid</td><td>It is the unique identifier (UUID) assigned to the wallet owner by the system. It is used to ensure data integrity.</td></tr><tr><td>Fullname</td><td>string</td><td>It is a textual expression containing the user's first and last name. Used for identity verification and representation purposes.</td></tr><tr><td>Email</td><td>string</td><td>It is the user's registered email address in the system. Used as a reference in notifications, authorization, and communication processes.</td></tr><tr><td>PhoneNumber</td><td>string</td><td>It is the wallet owner's mobile phone number. Used in verification codes and two-factor authentication processes.</td></tr><tr><td>TaxNumber</td><td>string</td><td>It is the Tax Identification Number (TIN) valid for corporate users. Provides system control in tax-related obligations.</td></tr><tr><td>IdentityNumber</td><td>string</td><td>It is the Turkish Republic Identity Number (TCKN) valid for individuals. Required for querying in KYC (Know Your Customer) processes.</td></tr><tr><td>OwnerType</td><td>string</td><td>Specifies the role type of the wallet owner in the system. Accepted values: MERCHANT, SUB_MERCHANT. Defines the data model hierarchy.</td></tr><tr><td>CompanyName</td><td>string</td><td>It is the registered trade name for corporate users. Used in invoices, transaction history, and user interface displays.</td></tr><tr><td>Address</td><td>string</td><td>It is the user's registered full address in the system. Associated with courier, document delivery, and billing processes.</td></tr><tr><td>Country</td><td>string</td><td>It is the country code of the user's location in ISO 3166-1 alpha-2 format. Used in location-based service restrictions.</td></tr><tr><td>City</td><td>string</td><td>It is the city information of the user's address. Used as a reference in regional differentiation and analysis.</td></tr><tr><td>DateOfBirth</td><td>Date</td><td>It is the date of birth for individual users. Format: YYYY-MM-DD. Serves as a verification criterion in age-restricted transactions.</td></tr><tr><td>MerchantId</td><td>int</td><td>It is the merchant ID to which the wallet owner is associated. Sub-user relationships are established through this ID.</td></tr><tr><td>CreatedAt</td><td>DateTime</td><td>It is the date and time when the related record was first created in the system. Stored in timestamp format.</td></tr><tr><td>UpdatedAt</td><td>DateTime</td><td>It is the timestamp of the most recent update. Used in change tracking and synchronization processes.</td></tr></tbody></table>