> 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/2.-create.md).

# 2. Create

## Create Wallet Owner

<mark style="color:yellow;">`POST`</mark> `{{Base Adres}}/api/v1/walletowner`

{% hint style="info" %}
**Note:** Before calling this service, it is required to 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="103.26171875">Type</th><th width="133.2421875">Compulsory</th><th width="403">Description</th></tr></thead><tbody><tr><td>apikeypublic</td><td>string</td><td>Yes</td><td>A public key generated through the merchant panel, used for authentication purposes in API calls.</td></tr><tr><td>apiclientpublic</td><td>string</td><td>Yes</td><td>A public client key generated through the merchant panel, used to identify the client information during API access.</td></tr></tbody></table>

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

```json
{
    "FullName": "Test User",
    "Email": "user@gmail.com",
    "PhoneNumber": "+9052323200000",
    "OwnerType": 1, // 1: Individual | 2: Corporate
    "TaxNumber": "", // for Corporate
    "IdentityNumber": null, // for individual
    "Address": "address",
    "Country": "country",
    "City": "city",
    "DateOfBirth": "2030-10-15",
    "CompanyName": ""
}
```

{% endtab %}
{% endtabs %}

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

```json
{
    "Value": {
        "Id": "529a2e8a-fd42-43d5-a87f-49b3c6a5c145",
        "Fullname": "yiğit",
        "Email": "Ciara_Vandervort@hotmail.com",
        "PhoneNumber": "+9052323221591",
        "TaxNumber": "",
        "IdentityNumber": "11111111110",
        "OwnerType": "Individual",
        "CompanyName": "Gutkowski - Turcotte",
        "Address": "address",
        "Country": "country",
        "City": "city",
        "DateOfBirth": "2030-10-15",
        "MerchantId": 2071,
        "CreatedAt": "2025-04-21T20:11:59.6115129Z",
        "UpdatedAt": null
    },
    "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 the API response contains a failure. If true, the operation has resulted in a negative outcome. This value should be checked in the process flow.</td></tr><tr><td>IsSuccess</td><td>bool</td><td>Indicates whether the API call was successfully completed. If true, the result is considered valid. This field is used as the main reference in status evaluations.</td></tr><tr><td>Errors</td><td>Array</td><td>A detailed list of messages related to errors that occurred during the operation. Used for reporting problematic situations. Contributes to the feedback mechanism.</td></tr><tr><td>Value</td><td>Array&#x3C;Items></td><td>The data object returned as a result of the operation. The data type it contains may vary depending on the endpoint. It serves as the main container of the returned content.</td></tr></tbody></table>

## Service Response (Value)

| Parameter      | Type     | Description                                                                                                                       |
| -------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------- |
| Id             | Guid     | A unique identifier assigned by the system for each user. Used as an in-application reference.                                    |
| Fullname       | string   | Stores the wallet owner's first and last name together. Displayed as an identity information field.                               |
| Email          | string   | The user's registered email address. Notifications, alerts, and communication channels are managed through this address.          |
| PhoneNumber    | string   | The user's phone number information. Processed in verification procedures when necessary.                                         |
| TaxNumber      | string   | The tax number information defined for users who are taxpayers. Actively used in tax-related transactions.                        |
| IdentityNumber | string   | An identification number specifically assigned to real persons. Serves as a reference in identity verification and KYC processes. |
| OwnerType      | string   | Specifies the type of the wallet owner. Valid values: MERCHANT, SUB\_MERCHANT. It is a scope-defining parameter.                  |
| CompanyName    | string   | Specifies the company name valid for corporate users. Displayed in company-based transactions.                                    |
| Address        | string   | The address information provided by the user during registration. Available for use in logistics and localization needs.          |
| Country        | string   | Represents the country location of the wallet owner. Used as a basis for regional restrictions and campaign targeting.            |
| City           | string   | The city information of the address. Can be used in region-based filtering.                                                       |
| DateOfBirth    | Date     | Specifies the user's date of birth. It is part of the registration process specific to real persons.                              |
| MerchantId     | int      | The merchant ID to which the wallet owner is linked. Maintained in the system as the top-level connection point.                  |
| CreatedAt      | DateTime | The date and time when the user was created in the system. A primary tracking field in log analysis.                              |
| UpdatedAt      | DateTime | Indicates the last time the user's information was updated. Taken as the basis in change tracking.                                |


---

# 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/2.-create.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.