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
The parameters that must be sent to the service are as follows:
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.
{
"FullName": "Test User",
"Email": "[email protected]",
"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": ""
}{
"Value": {
"Id": "529a2e8a-fd42-43d5-a87f-49b3c6a5c145",
"Fullname": "yiğit",
"Email": "[email protected]",
"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
}Service Response
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)
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.
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.
Last updated