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:

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

PaymentExternalAuthCode

string

İlgili parametrenin dolu gelmesi için sağlayıcının (Banka/PF) değeri dönmesi gerekmektedir

PaymentExternalOrderId

string

İlgili parametrenin dolu gelmesi için sağlayıcının (Banka/PF) değeri dönmesi gerekmektedir

PaymentExternalTransId

string

İlgili parametrenin dolu gelmesi için sağlayıcının (Banka/PF) değeri dönmesi gerekmektedir

PaymentExternalHostReference

string

İlgili parametrenin dolu gelmesi için sağlayıcının (Banka/PF) değeri dönmesi gerekmektedir

PaymentExternalMerchantId

string

İlgili parametrenin dolu gelmesi için sağlayıcının (Banka/PF) değeri dönmesi gerekmektedir

{
    "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,
            "PaymentExternalAuthCode": "",
            "PaymentExternalOrderId": "",
            "PaymentExternalTransId": "",
            "PaymentExternalHostReference": "",
            "PaymentExternalMerchantId": ""
        }
    }
}

Last updated