7. Vergi Numarası ile Sorgula

Belirtilen vergi numarası üzerinden cüzdan sahibi kaydına erişmek için bu servisin gerekli parametrelerle birlikte kullanılması gerekmektedir.

Cüzdan Kaydını Vergi Numarasıyla Tanımla

GET {{WalletUrl}}/api/v1/walletowner/by/taxnumber?TaxNumber=5049155355

Not: Bu servisi çağırmadan önce, apikeypublic ve apiclientpublic parametrelerini Header kısmına eklemeniz gereklidir.

WalletAPI Adresi

Servise gönderilmesi gereken parametreler şu şekildedir:

Parametre	Tip	Zorunlu	Açıklama
apikeypublic	string	Evet	API servislerine yapılan isteklerde kimlik doğrulaması için kullanılan genel anahtar bilgisidir.
apiclientpublic	string	Evet	API çağrısının hangi istemciden geldiğini belirtmek için kullanılan genel istemci anahtarıdır.

Servise gönderilmesi gereken (QueryString) parametreler şu şekildedir:

Parametre	Açıklama
TaxNumber	Aramak istediğiniz cüzdan sahibinin vergi numarası bilgisi

Servis Cevap - Json

{
    "Value": {
        "Id": "b5708099-be62-4d34-af06-27132082eb78",
        "MaskedFullname": "y***t",
        "Email": "[e-mail]",
        "PhoneNumber": "[phone]",
        "MaskedTaxNumber": "50*******5",
        "MaskedIdentityNumber": null,
        "OwnerType": "Corporate",
        "CompanyName": "Prosacco - McCullough",
        "Address": "address",
        "Country": "country",
        "City": "city",
        "DateOfBirth": "2030-10-15",
        "MerchantId": 2071,
        "CreatedAt": "2025-04-24T09:00:55.692674Z",
        "UpdatedAt": null,
        "Wallets": []
    },
    "Errors": [],
    "IsSuccess": true,
    "IsFailure": false
}

Servis Cevap

Parametre	Tip	Açıklama
IsFailure	bool	Yapılan API çağrısının başarısız olup olmadığını belirten değerdir. (true/false)
IsSuccess	bool	Yapılan API çağrısının başarılı olup olmadığını belirten değerdir. (true/false)
Errors	Array	Servis çağrısı sırasında oluşan hata mesajlarını ve detaylarını içeren alandır.
Value	Array<Items>	Başarılı API çağrısında dönen asıl veri kümesini temsil eder.

Servis Cevap (Value)

Parametre	Tip	Açıklama
Id	Guid	Sistemde tanımlı varlığın benzersiz kimlik numarasıdır.
MaskedFullname	string	Kullanıcının tam adının gizlenmiş (maskelenmiş) haliyle gösterildiği bilgidir.
Email	string	Kullanıcının kayıtlı e-posta adresi bilgisidir.
PhoneNumber	string	Kullanıcının kayıtlı telefon numarası bilgisidir.
MaskedTaxNumber	string	Kullanıcının vergi numarasının gizlenmiş (maskelenmiş) şekilde gösterildiği numaradır.
MaskedIdentityNumber	string	Kullanıcının kimlik numarasının gizlenmiş (maskelenmiş) şekilde gösterildiği bilgidir.
OwnerType	string	Cüzdan sahibinin türünü belirtir (bireysel kullanıcı mı, kurumsal mı olduğunu gösterir).
CompanyName	string	Eğer cüzdan sahibi kurumsal ise, kayıtlı şirket adını gösterir.
Address	string	Cüzdan sahibinin kayıtlı açık adres bilgisidir.
Country	string	Cüzdan sahibinin kayıtlı olduğu ülke bilgisidir.
City	string	Cüzdan sahibinin kayıtlı olduğu şehir bilgisidir.
DateOfBirth	Date	Cüzdan sahibinin doğum tarihi bilgisidir.
MerchantId	int	İlgili kullanıcının ilişkilendirildiği üye iş yeri (merchant) kimlik numarasıdır.
CreatedAt	DateTime	Kaydın sistemde oluşturulduğu tarih ve saat bilgisidir.
UpdatedAt	DateTime	Kaydın en son güncellendiği tarih ve saat bilgisidir.
Wallets	List	Kullanıcıya ait cüzdanların bilgilerini içeren liste alanıdır.