5. Update

To update an existing wallet owner record, the service on this page must be used with the required parameters.

Update Wallet Owner Information

PUT {{WalletUrl}}/api/v1/walletowner

Note: Before calling this service, you must 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	It is the public key sent to authenticate the identity during API access. Security checks are performed based on this value.
apiclientpublic	string	Yes	It is the client key that identifies the requesting application. Used for authorizing API calls.

Service Request - JSON

{
  "Id": "0000-0000-0000-0000-0000",
  "Name": "{{$randomFullName}}",
  "Email": "{{$randomEmail}}",
  "PhoneNumber": "[phone]",
  "Address": "{{$randomStreetAddress}}",
  "Country": "{{$randomCountry}}",
  "City": "{{$randomCity}}",
  "DateOfBirth": "2001-03-03",
  "CompanyName": "{{$randomCompanyName}}"
}

Service Request - JSON

{
    "Value": {
        "Id": "9ef565a2-5987-4da4-8b0e-f0b392196e7e",
        "Fullname": "yiğit",
        "Email": "[email protected]",
        "PhoneNumber": "[phone]",
        "TaxNumber": "",
        "IdentityNumber": "68567422314",
        "OwnerType": "Individual",
        "CompanyName": "Schuster - Labadie",
        "Address": "57152 Koepp Prairie",
        "Country": "Senegal",
        "City": "Volkmanberg",
        "DateOfBirth": "2001-03-03",
        "MerchantId": 2071,
        "CreatedAt": "2025-04-22T12:40:20.724936Z",
        "UpdatedAt": "2025-04-22T12:41:09.1561171Z"
    },
    "Errors": [],
    "IsSuccess": true,
    "IsFailure": false
}

Service Response

Parameter	Type	Description
IsFailure	bool	Indicates whether there is an error in the service response. If true, it means the operation has failed. This should be considered during evaluation.
IsSuccess	bool	Indicates whether the operation was completed as expected. A true value signifies successful execution. It is used as a reference in result verification.
Errors	Array	Contains error information that occurred during the service call. Errors are typically presented with an error code and description. Used for troubleshooting.
Value	Array<Items>	Represents the core data content returned by the service. The results are transmitted to the user through this field. The return type may vary depending on the operation performed.

Service Response (Value)

Parameter	Type	Description
Id	Guid	It is the unique identifier (UUID) assigned to the wallet owner by the system. It is used to ensure data integrity.
Fullname	string	It is a textual expression containing the user's first and last name. Used for identity verification and representation purposes.
Email	string	It is the user's registered email address in the system. Used as a reference in notifications, authorization, and communication processes.
PhoneNumber	string	It is the wallet owner's mobile phone number. Used in verification codes and two-factor authentication processes.
TaxNumber	string	It is the Tax Identification Number (TIN) valid for corporate users. Provides system control in tax-related obligations.
IdentityNumber	string	It is the Turkish Republic Identity Number (TCKN) valid for individuals. Required for querying in KYC (Know Your Customer) processes.
OwnerType	string	Specifies the role type of the wallet owner in the system. Accepted values: MERCHANT, SUB_MERCHANT. Defines the data model hierarchy.
CompanyName	string	It is the registered trade name for corporate users. Used in invoices, transaction history, and user interface displays.
Address	string	It is the user's registered full address in the system. Associated with courier, document delivery, and billing processes.
Country	string	It is the country code of the user's location in ISO 3166-1 alpha-2 format. Used in location-based service restrictions.
City	string	It is the city information of the user's address. Used as a reference in regional differentiation and analysis.
DateOfBirth	Date	It is the date of birth for individual users. Format: YYYY-MM-DD. Serves as a verification criterion in age-restricted transactions.
MerchantId	int	It is the merchant ID to which the wallet owner is associated. Sub-user relationships are established through this ID.
CreatedAt	DateTime	It is the date and time when the related record was first created in the system. Stored in timestamp format.
UpdatedAt	DateTime	It is the timestamp of the most recent update. Used in change tracking and synchronization processes.