2. Create

To create a new wallet owner record, an API call must be made through the service on this page along with the required parameters.

Create Wallet Owner

POST {{Base Adres}}/api/v1/walletowner

Note: Before calling this service, it is required to include the apikeypublic and apiclientpublic parameters in the Header section.

WalletAPI Address

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

Parameter	Type	Required	Description
apikeypublic	string	Yes	A public key generated through the merchant panel, used for authentication purposes in API calls.
apiclientpublic	string	Yes	A public client key generated through the merchant panel, used to identify the client information during API access.

Service Response - JSON

{
    "FullName": "Test User",
    "Email": "[email protected]",
    "PhoneNumber": "[phone]",
    "OwnerType": 1, // 1: Individual | 2: Corporate
    "TaxNumber": "", // for Corporate
    "IdentityNumber": null, // for individual
    "Address": "address",
    "Country": "country",
    "City": "city",
    "DateOfBirth": "2030-10-15",
    "CompanyName": ""
}

Service Response - JSON

{
    "Value": {
        "Id": "529a2e8a-fd42-43d5-a87f-49b3c6a5c145",
        "Fullname": "yiğit",
        "Email": "[email protected]",
        "PhoneNumber": "[phone]",
        "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
}

Service Response

Parameter	Type	Description
IsFailure	bool	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.
IsSuccess	bool	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.
Errors	Array	A detailed list of messages related to errors that occurred during the operation. Used for reporting problematic situations. Contributes to the feedback mechanism.
Value	Array<Items>	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.

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.