> For the complete documentation index, see [llms.txt](https://developer.paywall.one/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.paywall.one/payment-orchestration-integration-document/wallet-services/1.-wallet-owners/5.-update.md).

# 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>](/payment-orchestration-integration-document/environment.md)
{% endhint %}

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

<table><thead><tr><th width="162">Parameter</th><th width="93.58984375">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
{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "Id": "0a949877-0ea0-48c3-9c92-41c9e33c461d",
        "Fullname": "Enes Selman",
        "Email": "Irwin.Funk@yahoo.com",
        "PhoneNumber": "+905350533481",
        "TaxNumber": "8430816988",
        "IdentityNumber": null,
        "OwnerType": "Corporate",
        "CompanyName": "test",
        "Address": "address",
        "Country": "country",
        "City": "city",
        "DateOfBirth": "2030-10-15",
        "CreatedAt": "2025-08-20T09:59:58.070493Z",
        "UpdatedAt": "2025-08-20T10:01:07.7344151Z"
    }
}
```

{% 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>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developer.paywall.one/payment-orchestration-integration-document/wallet-services/1.-wallet-owners/5.-update.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.