1. List

Access the wallet owners (users) list via the service on this page.

Wallet Owner List

GET {{Base Adres}}/api/v1/walletowner?OwnerType=1&PageNumber=1&PageSize=10

Note: Before calling this service, you must include the apikeypublic and apiclientpublic parameters in the Header section.

WalletAPI Address

Parameters Required in the Header:

Parameter	Type	Required	Description
apikeypublic	string	Yes	Public Key obtained from your merchant panel.
apiclientpublic	string	Yes	Public Client obtained from your merchant panel.

Parameters Required in the QueryString:

Parameter	Description
OwnerType	The type of wallet owners to be listed See: Wallet Owner Types
PageNumber	Which page number would you like to list
PageSize	How many records do you want per page

Service Response - JSON

{
    "Items": [
        {
            "Id": "59cba0b2-6c2a-43b0-a560-2f795ea6dea8",
            "Fullname": "yiğit",
            "Email": "[email protected]",
            "PhoneNumber": "[phone]",
            "TaxNumber": "",
            "IdentityNumber": null,
            "OwnerType": "Individual",
            "CompanyName": "Jones, Kerluke and Abshire",
            "Address": "address",
            "Country": "country",
            "City": "city",
            "DateOfBirth": "2030-10-15",
            "MerchantId": 2071,
            "CreatedAt": "2025-04-09T10:29:00.452264Z",
            "UpdatedAt": null
        }
    ],
    "PageNumber": 1,
    "TotalPages": 1,
    "TotalCount": 1,
    "HasPreviousPage": false,
    "HasNextPage": false,
    "Errors": [],
    "IsSuccess": true,
    "IsFailure": false
}

Service Response

Parameter	Type	Description
IsFailure	bool	Indicates whether the operation has failed. If the value is true, the operation is considered invalid. Necessary updates have been made
IsSuccess	bool	Indicates that the operation was completed successfully. A value of true should be returned for successful results. Version control has been verified
Errors	Array	Contains the messages generated by the system in case of errors. Used for proper error handling. Updated according to test scenarios.
HasNextPage	bool	Indicates whether there is a next page. Used for pagination operations. Additional enhancements have been applied.
HasPreviousPage	bool	Indicates whether a previous page exists. Important for page navigation logic. The structure has been optimized.
TotalCount	int	Returns the total number of all filtered results. It is the main reference point for listing operations. Integrated with the background service.
TotalPages	int	Indicates the total number of pages generated as a result of pagination. Important in dynamic result structures. Defined in accordance with the parameter standard.
Items	Array<Items>	Contains the data set returned on the current page. Typically presented in list format. Defined to match the data model.

Service Response (Items)

Parameter	Type	Description
Id	Guid	A unique identifier assigned by the system to each wallet owner. Synchronized with internal processes.
Fullname	string	The full name information of the wallet owner. Required for both individual and corporate use.
Email	string	The user's registered email address in the system. Used for notifications and communication.
PhoneNumber	string	The registered mobile phone number of the wallet owner. Plays an active role in verification processes.
TaxNumber	string	A valid tax identification number for users who are taxpayers. Linked to the control system.
IdentityNumber	string	An identification number required for real persons. Connected to identity verification services.
OwnerType	string	Specifies the user type to which the wallet belongs (MERCHANT, SUB_MERCHANT). Used as a discriminator in query structures.
CompanyName	string	The valid company name for corporate wallet owners. Collected according to corporate transaction workflows.
Address	string	The user's registered full address information. Required for needs such as delivery and reporting.
Country	string	The country information of the wallet owner. Used as a reference in regional services.
City	string	The city information provided during registration. Used in location-based filters.
DateOfBirth	Date	The date of birth of individual wallet owners. Serves as a complement to the user profile.
MerchantId	int	The merchant ID associated with the wallet owner. Represents the internal system linkage.
CreatedAt	DateTime	The date and time when the wallet owner was first registered in the system. Important for tracking purposes.
UpdatedAt	DateTime	Indicates the last time the information related to the user was updated. Considered important for versioning purposes.