# 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>](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>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.                                |