5. Takip Kodu

Ödeme'nizi ilgili ödeme anında verdiğiniz TrackingCode bilgisiyle sorgulamak için bu servisi kullanabilirsiniz. İlgili servis, belirtilen TrackingCode bilgisine sahip tüm ödemeleri dönmektedir

Ödeme Sorgulama (TrackingCode)

GET {{Private Base Address}}/api/paywall/private/query/by/trackingcode

Önemli: Ödeme Sorgulama (TrackingCode) servisini kullanabilmeniz için 'Header' alanında 'apikeyprivate' ve 'apiclientprivate' parametrelerini göndermeniz gerekmektedir. PaymentPrivateAPI Adresi

Takip numarası (TrackingCode) bilgisiyle ödeme sorgulama servisi maksimum 100 kayıt dönmektedir.

Parametre	Tip	Zorunlu	Açıklama
apikeyprivate	string	Evet	Üye işyeri panelinden temin etmiş olduğunuz Public Key.
apiclientprivate	string	Evet	Üye işyeri panelinden temin etmiş olduğunuz Public Client.
merchantuniquecode	string	Opsiyonel	Ödeme'ye ait sizin tarafınızdan verilmiş olan tekil takip kodu
trackingcode	string	Evet	Ödeme'ye ait sizin tarafınızdan verilmiş olan takip kodu (TrackingCode)

Örnek Kod:

C#

using System;
using System.Net.Http;
using System.Threading.Tasks;
using Newtonsoft.Json;

public class Program
{
    private static readonly HttpClient client = new HttpClient();

    private static async Task Main()
    {
        client.DefaultRequestHeaders.Add("apikeyprivate", "%PRIVATEKEY%");
        client.DefaultRequestHeaders.Add("apiclientprivate", "%PRIVATECLIENT%");
        client.DefaultRequestHeaders.Add("merchantuniquecode", "%MerchantUniqueCode%"); // Opsiyonel
        client.DefaultRequestHeaders.Add("trackingcode", "%TrackingCode%");
        var response = await client.GetAsync("{{Private Base Address}}/api/paywall/private/query/by/trackingcode");
        var responseString = await response.Content.ReadAsStringAsync();
        var responseObject = JsonConvert.DeserializeObject<Response>(responseString);
        Console.WriteLine(responseObject.Body.Paywall.StatusName);
    }

    public class Response
    {
        public int ErrorCode { get; set; }
        public bool Result { get; set; }
        public string Message { get; set; }
        public Body Body { get; set; }
    }

    public class Body
    {
        public List<PaywallList> List { get; set; }
    }

    public class PaywallList
    {
        public int PaymentId { get; set; }
        public int ActivityId { get; set; }
        public bool Status { get; set; }
        public string StatusName { get; set; }
        // Define other properties as needed...
    }
}

Parametre Açıklamaları (Liste dönmektedir):

Parametre	Tip	Açıklama
PaymentId	int	Ödeme kimliği
UniqueCode	Guid	Paywall'un ödemeye ilişkin ürettiği tekil takip numarası
MerchantUniqueCode	string	Üye işyerinin, ödeme başlatma anında verdiği tekil takip numarası
TrackingCode	string	Üye işyerinin, ödeme başlatma anında verdiği takip numası
ActivityId	int	Ödeme son hareket kimliği
PaymentGatewayId	int	İşlemin gerçekleştiği sağlayıcının bağlantı kimlik numarası
PaymentGatewayName	string	İşlemin gerçekleştiği sağlayıcının bağlantı ismi
PaymentGatewayProviderName	string	İşlemin gerçekleştiği sağlayıcının sistemdeki ismi
IsThreeDSecure	bool	İşlem 3D mi?
IsNonThreeDSecure	bool	İşlem Non-3D mi?
IsInsuranceSecure	bool	İşlem sigortacılığa özel ilk 8 son 4 mü?
IsProvision	bool	İşlem ön provizyonlu mu?
IsOtp	bool	İşlem Otp yöntemiyle mi gerçekleşiyor?
AnySuccessPayment	bool	İşlem kapsamında başarılı satış var mı?
AnySuccessRefund	bool	İşlem kapsamında başarılı iade var mı?
AnySuccessPartialRefund	bool	İşlem kapsamında başarılı kısmi iade var mı?
AnySuccessCancel	bool	İşlem kapsamında başarılı iptal var mı?
Status	boolean	Son hareketin durumu, true: başarılı / false: başarısız
StatusName	string	Ödeme durumu
StatusId	int	Ödeme durum kimliği
TypeName	string	Ödeme son hareket tipi
TypeId	int	Ödeme son hareket tipinin kimliği
Installment	int	Taksit bilgisi
CurrencyId	int	Ödeme para birimi kimliği
CurrencyName	string	Ödeme para birimi
PaymentMethodId	int	Ödeme yöntemi kimliği Bkz: Ödeme Yöntemleri
PaymentMethodName	string	Ödeme yöntemi
PaymentChannelId	int	Ödeme kanal kimliği Bkz: Ödeme Kanalları
PaymentChannelName	string	Ödeme kanalı
PaymentTagId	int	Ödeme etiket kimliği
PaymentTagName	string	Ödeme etiketi
CardNumber	string	Maskeli kart numarası
CardOwnerName	string	Maskeli kart sahibinin ismi
CardBankId	int	Kart bankasının kimliği
CardBankName	string	Kart bankasının ismi
CardBrandId	int	Kart markasının kimliği
CardBrandName	string	Kart markasının ismi
CardTypeId	int	Kart tipinin kimliği
CardTypeName	string	Kart tipinin ismi
CardFamilyId	int	Kart ailesinin kimliği
CardFamilyName	string	Kart ailesinin ismi
LastActivityDateTime	DateTime	İşlem özelinde yapılan son işlemin tarih/saat bilgisi
PaymentAmount	decimal	Ödemenin ana tutarı
ActivityAmount	decimal	Son işlem tutarı Örnek: 1000TL'lik bir ana tutarlı işlem 100TL kısmi iade yapıldıysa bu parametre 100 olarak dönmektedir
IP	string	İşlemin gönderildiği IP bilgisi
ClientIP	string	Ödeme anında iletilen, ödemenin gerçekleştiği cihazın IP bilgisi
AppliedInterest	bool	Ödemeye vade uygulandı mı?
InterestRate	decimal?	Ödemeye uygulanan vade oranı
CommissionRate	decimal?	Ödemenin gerçekleştiği sağlayıcının uyguladığı komisyon bilgisi Paywall panelinden ayarladığınız değer dönmektedir
OriginalAmount	decimal	Ödemenin orjinal tutarı Örnek: Eğer ödeme 1000TL ise ve 100TL vade uygulanma sonucunda çekilen tutar 1100TL olduysa. Bu parametre 1000TL olarak vade uygulanmamış orjinal haliyle döner
InterestAmount	decimal?	Varsa, uygulanan vade tutarı
CommissionAmount	decimal	Ödeme kuruluşu/banka tarafından ödemeye uygulanan komisyon tutarı
UsedSavedCard	bool	İlgili ödeme kayıtlı kartla mı gerçekleşti?
UsedTempCard	bool	İlgili ödeme client-side tokenize edilmiş kartla mı gerçekleşti?

Json

{
    "ErrorCodeType": 1,
    "ErrorMessage": null,
    "ErrorCode": 0,
    "Result": true,
    "Message": "",
    "Body": {
        "List": [
            {
                "PaymentId": 4045719,
                "UniqueCode": "5cd67b1e-9b1d-49ee-bf73-96b9d004a73f",
                "MerchantUniqueCode": "b735a618-f775-434e-9a96-b5f3d0502b14",
                "TrackingCode": "tracking-code-1234567890",
                "ActivityId": 8907405,
                "PaymentGatewayId": 1570,
                "PaymentGatewayName": "ProviderConnectionName",
                "PaymentGatewayProviderName": "ProviderSystemName",
                "IsThreeDSecure": false,
                "IsNonThreeDSecure": true,
                "IsInsuranceSecure": false,
                "IsProvision": true,
                "IsOtp": false,
                "AnySuccessPayment": false,
                "AnySuccessRefund": false,
                "AnySuccessPartialRefund": false,
                "AnySuccessCancel": false,
                "Error": {
                    "AnyError": false,
                    "ErrorType": 0,
                    "ErrorMessage": ""
                },
                "Status": false,
                "StatusName": "Finansallaştırma Bekliyor",
                "StatusId": 3,
                "TypeName": "Satış",
                "TypeId": 1,
                "Installment": 1,
                "CurrencyId": 1,
                "CurrencyName": "TRY",
                "PaymentMethodId": 4,
                "PaymentMethodName": "Half Direct Payment",
                "PaymentChannelId": 0,
                "PaymentChannelName": null,
                "PaymentTagId": 0,
                "PaymentTagName": null,
                "CardNumber": "552879******0008",
                "CardOwnerName": "Enes Selman Tütüncü",
                "CardBankId": 55,
                "CardBankName": "T.HALK BANKASI A.Ş.",
                "CardBrandId": 1,
                "CardBrandName": "Master Card",
                "CardTypeId": 1,
                "CardTypeName": "Credit",
                "CardFamilyId": 5,
                "CardFamilyName": "Paraf",
                "LastActivityDateTime": "2025-06-04T23:39:29.0246554",
                "PaymentAmount": 1000.00,
                "ActivityAmount": 1000.00,
                "IP": "78.190.218.158",
                "ClientIP": null,
                "AppliedInterest": false,
                "InterestRate": 0.00,
                "CommissionRate": 0.00,
                "OriginalAmount": 1000.00,
                "InterestAmount": 0.00,
                "CommissionAmount": 0.00,
                "UsedSavedCard": true,
                "UsedTempCard": false
            },
            {
                "PaymentId": 4045718,
                "UniqueCode": "3208b4c0-646b-453a-b555-4685bd62867b",
                "MerchantUniqueCode": "a2720c3b-7490-41cc-adfd-1edfbf5d1177",
                "TrackingCode": "tracking-code-1234567890",
                "ActivityId": 8907402,
                "PaymentGatewayId": 1570,
                "PaymentGatewayName": "ProviderConnectionName",
                "PaymentGatewayProviderName": "ProviderSystemName",
                "IsThreeDSecure": false,
                "IsNonThreeDSecure": true,
                "IsInsuranceSecure": false,
                "IsProvision": true,
                "IsOtp": false,
                "AnySuccessPayment": false,
                "AnySuccessRefund": false,
                "AnySuccessPartialRefund": false,
                "AnySuccessCancel": false,
                "Error": {
                    "AnyError": false,
                    "ErrorType": 0,
                    "ErrorMessage": ""
                },
                "Status": false,
                "StatusName": "Finansallaştırma Bekliyor",
                "StatusId": 3,
                "TypeName": "Satış",
                "TypeId": 1,
                "Installment": 1,
                "CurrencyId": 1,
                "CurrencyName": "TRY",
                "PaymentMethodId": 4,
                "PaymentMethodName": "Half Direct Payment",
                "PaymentChannelId": 0,
                "PaymentChannelName": null,
                "PaymentTagId": 0,
                "PaymentTagName": null,
                "CardNumber": "552879******0008",
                "CardOwnerName": "Enes Selman Tütüncü",
                "CardBankId": 55,
                "CardBankName": "T.HALK BANKASI A.Ş.",
                "CardBrandId": 1,
                "CardBrandName": "Master Card",
                "CardTypeId": 1,
                "CardTypeName": "Credit",
                "CardFamilyId": 5,
                "CardFamilyName": "Paraf",
                "LastActivityDateTime": "2025-06-04T23:39:26.7114128",
                "PaymentAmount": 1000.00,
                "ActivityAmount": 1000.00,
                "IP": "78.190.218.158",
                "ClientIP": null,
                "AppliedInterest": false,
                "InterestRate": 0.00,
                "CommissionRate": 0.00,
                "OriginalAmount": 1000.00,
                "InterestAmount": 0.00,
                "CommissionAmount": 0.00,
                "UsedSavedCard": true,
                "UsedTempCard": false
            },
            {
                "PaymentId": 4045717,
                "UniqueCode": "2da4e8f0-91e2-4a99-8087-0f117be3f648",
                "MerchantUniqueCode": "94fe0960-396a-49f5-a290-bc6454bd12bd",
                "TrackingCode": "tracking-code-1234567890",
                "ActivityId": 8907399,
                "PaymentGatewayId": 1570,
                "PaymentGatewayName": "ProviderConnectionName",
                "PaymentGatewayProviderName": "ProviderSystemName",
                "IsThreeDSecure": false,
                "IsNonThreeDSecure": true,
                "IsInsuranceSecure": false,
                "IsProvision": true,
                "IsOtp": false,
                "AnySuccessPayment": false,
                "AnySuccessRefund": false,
                "AnySuccessPartialRefund": false,
                "AnySuccessCancel": false,
                "Error": {
                    "AnyError": false,
                    "ErrorType": 0,
                    "ErrorMessage": ""
                },
                "Status": false,
                "StatusName": "Finansallaştırma Bekliyor",
                "StatusId": 3,
                "TypeName": "Satış",
                "TypeId": 1,
                "Installment": 1,
                "CurrencyId": 1,
                "CurrencyName": "TRY",
                "PaymentMethodId": 4,
                "PaymentMethodName": "Half Direct Payment",
                "PaymentChannelId": 0,
                "PaymentChannelName": null,
                "PaymentTagId": 0,
                "PaymentTagName": null,
                "CardNumber": "552879******0008",
                "CardOwnerName": "Enes Selman Tütüncü",
                "CardBankId": 55,
                "CardBankName": "T.HALK BANKASI A.Ş.",
                "CardBrandId": 1,
                "CardBrandName": "Master Card",
                "CardTypeId": 1,
                "CardTypeName": "Credit",
                "CardFamilyId": 5,
                "CardFamilyName": "Paraf",
                "LastActivityDateTime": "2025-06-04T23:39:25.2136514",
                "PaymentAmount": 1000.00,
                "ActivityAmount": 1000.00,
                "IP": "78.190.218.158",
                "ClientIP": null,
                "AppliedInterest": false,
                "InterestRate": 0.00,
                "CommissionRate": 0.00,
                "OriginalAmount": 1000.00,
                "InterestAmount": 0.00,
                "CommissionAmount": 0.00,
                "UsedSavedCard": true,
                "UsedTempCard": false
            }
        ]
    }
}