2. Paywall İşlem Numarası

UniqueCode parametresiyle ödeme sorgulama işleminizi gerçekleştirebilirsiniz. UniqueCode, ödeme başlatma sonrasında Paywall tarafından oluşturulan ve cevapta döne tekil ödeme takip numarasıdır

Ödeme Sorgulama (UniqueCode)

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

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

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.
uniquecode	Guid	Evet	Ödeme'ye Paywall tarafından atanan tekil takip numarası

Ö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("uniquecode", "%UniqueCode%");
        var response = await client.GetAsync("{{Private Base Address}}/api/paywall/private/query/by/uniquecode");
        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 Paywall Paywall { get; set; }
    }

    public class Paywall
    {
        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ı:

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?
Activities	List	İşleme dair gerçekleşen tüm hareketler (Oluşturuldu, Satış Başladı, Satış Başarısız, İptal Başarılı vb)
IsFullyRefunded	bool	İşlemin tamamen iptal/iade edilip edilmediğinin bilgisi
RemainingRefundAmount	decimal	İade edilebilir toplam tutar. Kısmi iade yaptıkça bu tutar azalır

Json

{
    "ErrorCodeType": 1,
    "ErrorMessage": null,
    "ErrorCode": 0,
    "Result": true,
    "Message": "",
    "Body": {
        "Paywall": {
            "PaymentId": 4045713,
            "UniqueCode": "cdd14b16-74fd-4f3b-863f-fccb3ec80baf",
            "MerchantUniqueCode": "5b0287fb-0ccc-4366-9b2a-048be739e54c",
            "TrackingCode": "123123912831092831092-34534535-3453454",
            "ActivityId": 8907375,
            "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-04T18:42:27.5447456",
            "PaymentAmount": 1000.00,
            "ActivityAmount": 1000.00,
            "IP": "35.245.18.66",
            "ClientIP": null,
            "AppliedInterest": false,
            "InterestRate": 0.00,
            "CommissionRate": 0.00,
            "OriginalAmount": 1000.00,
            "InterestAmount": 0.00,
            "CommissionAmount": 0.00,
            "UsedSavedCard": true,
            "UsedTempCard": false
        }
    }
}