For the complete documentation index, see llms.txt. This page is also available as Markdown.

1. Yeni Kart

Yeni kart ekleme işlemini sadece sunucularınız (Back-End) üzerinden gerçekleştirmeniz önerilir. Uygulamalarınızdan (Son Kullanıcı) direkt erişim sağlamanız önerilmez.

Yeni Kart Sakla

POST {{Base Adres}}/paywall/card

Önemli: Kart işlemleri yüksek güvenlikli işlemlerdir. Bu nedenle 'Header' alanında 'apikeyprivate' ve 'apiclientprivate' parametrelerini göndermeniz gerekmektedir. CardWallAPI Adresi

Gerekli header ve istek parametreleri :

Zorunlu header parametreleri
Parametre
Tip
Zorunlu
Açıklama

apikeyprivate

string

Evet

Üye işyeri panelinden temin etmiş olduğunuz Private Key.

apiclientprivate

string

Evet

Üye işyeri panelinden temin etmiş olduğunuz Private Client.

İstek gövdesi parametreleri
Parametre
Tip
Zorunlu
Açıklama

PartnerBased

bool

Hayır

Eğer kartlar Partner'lik yönetimi kapsamında ortak bir havuzda kayıt edilecekse kullanılmalıdır

PartnerIdentity

string

Evet/Hayır

Partnerlik kapsamında kayıt edilecek ise Partner hesabınızın kimlik bilgisi

RelationalId1

string

Evet

Kart'ın ilişkilendirilmesi istenen unique bilgi

RelationalId2

string

Hayır

Kart'ın ilişkilendirilmesi istenen unique ikinci bilgi (listeleme anında tüm bilgiler gönderilmelidir)

RelationalId3

string

Hayır

Kart'ın ilişkilendirilmesi istenen unique üçüncü bilgi (listeleme anında tüm bilgiler gönderilmelidir)

Nickname

string

Evet

Kart'ın takma ismi (Örnek: Yüksek limitli kartım)

HolderName

string

Evet

Kart'ın üstündeki kart sahibi adı

Number

string

Evet

Kart'ın numarası

Month

int

Evet

Kart'ın son kullanılma tarihi (ay)

Year

int

Evet

Kart'ın son kullanılma tarihi (yıl) - Parametre 4 karakter olmalıdır

IncludeDetails

boolean

Hayır

Kartın detay bilgileri (Bin, Tip, Marka, Banka vs) dönsün istiyorsanız TRUEolarak göndermelisiniz

PreventDuplicate

bool

Hayır

Aynı kartın tekrar kayıt edilmesini engeller.

PreventDuplicateHours

int

Hayır

Aynı kullanıcının belirli bir merchant'a belirli saat aralığında yeni kart kaydını engeller.

Servise gönderilecek örnek bir JSON dosyası şu şekildedir :

{
    "PartnerBased": false,
    "PartnerIdentity": "",
    "RelationalId1": "1000923",
    "RelationalId2": "",
    "RelationalId3": "",
    "Card": {
        "Nickname": "İş bankası kartım",
        "HolderName": "Emir Selim Tütüncü",
        "Number": "4546711234567894",
        "Month": 12,
        "Year": 2026
    },
    "IncludeDetails": true,
    "PreventDuplicate": false, 
    "PreventDuplicateHours": 1
}

Servisten dönen parametreler şu şekildedir:

Parametreler ve açıklamaları
Parametre
Tip
Açıklama

ErrorCode

int

Hata kodu. İşlem başarılı ise '0' değerini döner.

Result

bool

True ya da false değeri döner. İşlem başarılı iste 'true' değerini döner.

Message

string

İşlem hatalıysa, bu hataya dair belirtilen mesajdır, locale parametresine göre dil desteği sunar.

Body

nesne

İşlem hatalıysa, bu hataya dair detay nesne

Name

string

Kullanıcının karta verdiği özel isim.

CardBin

string

Kart'a ait BIN bilgisi

CardLastFour

string

Kart'ın son 4 hanesi

CardHolderName

string

Kart sahibinin maskeli adı.

CardNumber

string

Maskeli kart numarası. Ekranlarında listeletebilirsiniz.

CardTypeId

int

Kart'ın markasını ifade eder. MasterCard, Visa vs

CardType

string

Kart'ın markasını string olarak döner

Month

int

Kartın son kullanma ayı.

Year

int

Kartın son kullanma yılı.

UniqueCode

string

Kart ile ödeme yapılmak istendiğinde kullanılması gereken kart kimliğidir. Bu bilgi belli periyotlarda değişmektedir. Bu nedenle kayıtlı karta ait UniqueCode bilgileri saklanmamalıdır. Her ödeme öncesinde Paywall üzerinden kart listesi alınmalıdır.

Details.CardBankId

int

Kartın ait olduğu bankanın ID değeri.

Details.CardBank

string

Kartın ait olduğu bankanın adı.

Details.CardBrandId

int

Kart markasının ID değeri.

Details.CardBrand

string

Kart markasının adı.

Details.CardFamilyId

int

Kart ailesinin ID değeri.

Details.CardFamily

string

Kart ailesinin adı.

Details.CardKindId

int

Kartın bireysel/kurumsal ayrımının ID değeri.

Details.CardKind

string

Kartın bireysel/kurumsal ayrımı.

Details.CardTypeId

int

Kartın debit/credit/prepaid ayrımının ID değeri.

Details.CardType

string

Kartın debit/credit/prepaid ayrımı.

Last updated