5. Kart Güncelle

Kayıtlı kartı güncelleme 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.

Kayıtlı Kart Güncelleme

PUT {{Base Adres}}/paywall/card

Yukarıda verilmiş olan adrese istek atmanız yeterli olacaktır. Test ortamı ve Gerçek ortam için 'Base Address' istediğiniz gibi kullanabilirsiniz.

Ö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	Partner'lik kapsamında kayıt edilen kartlar için geçerlidir
PartnerIdentity	string	Evet/Hayır	Partner'lik kapsamında kayıt edilen kartlar için geçerlidir
RelationalId1	string	Evet	Kart'ın ilişkilendirildiği unique bilgi
RelationalId2	string	Hayır	Kart'ın ilişkilendirildiği ikinci unique bilgi
RelationalId3	string	Hayır	Kart'ın ilişkilendirildiği üçüncü unique bilgi
UniqueCode	string	Evet	Saklı karta ait unique bilgi (kimlik)
Nickname	string	Evet	Kart'ın takma ismi (Örnek: Yüksek limitli kartım)
Month	int	Evet	Saklı kartın güncellenmek istenen son kullanma tarihi (Ay)
Year	int	Evet	Saklı kartın güncellenmek istenen son kullanma tarihi (Yıl)

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

JSON

{
    "PartnerBased": false,
    "PartnerIdentity": "",
    "RelationalId1": "003",
    "RelationalId2": "004",
    "RelationalId3": "",
    "UniqueCode": "921245xQN85D0+Zuf7oAJv5@@@@@G86eN7RA4cX8L4hHo7Ma3hg7AW7Bq232yPyw2iVPkrt1qEw==",
    "Nickname": "Yurtdışı kartım",
    "Month": 12,
    "Year": 2030
}

Servisten dönen parametreler şu şekildedir:

Parametreler ve açıklamaları

Parametre	Tip	Açıklama
ErrorCode	int	İşlem sonucunu bildirir. İşlem başarılı ise '0' değilse '1' döner
Result	string	İşlem Başarılı ise 'true' değilse 'false' değeri döner
Message	string	İşlem sonuç mesajını bildirir.
Body	nesne	İşlem hatalıysa, bu hataya dair detay nesne

JSON

{
    "ErrorCode": 0,
    "Result": true,
    "Message": "",
    "Body": ""
}