2. Yeni Kart/Tokenizasyon

İstemci (Client) üzerinden tokeniz edilmiş kart bilgisini, sunucularınız üzerinden, ilgili kullanıcı bilgileriyle birlikte kayıt altına alabilirsiniz

Yeni Kart Sakla / Tokenizasyon

POST {{Base Adres}}/paywall/card/tokenization

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

Servise gönderilmesi gereken (HEADERS) parametreler şu şekildedir :

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.

Servise gönderilmesi gereken (BODY) parametreler şu şekildedir :

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)
CardToken	Guid	Evet	İstemci (Client) tarafından tokenize edilmiş kart bilgisinin kendisidir
IncludeDetails	boolean	Hayır	Kartın detay bilgileri (Bin, Tip, Marka, Banka vs) dönsün istiyorsanız TRUEolarak göndermelisiniz

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

JSON

{
    "PartnerBased": false,
    "PartnerIdentity": "",
    "RelationalId1": "1000923",
    "RelationalId2": "",
    "RelationalId3": "",
    "Card": {
        "CardToken": "580a3866-0055-4486-8c4b-96c8ac173e32",
        "Nickname": "Test Nickname"
    },
    "IncludeDetails": true
}

Servisten dönen parametreler şu şekildedir:

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

JSON

{
    "ErrorCode": 4,
    "Result": false,
    "Message": "Card already exists",
    "Body": {
        "Scope": 0,
        "Name": "Test Card",
        "CardBin": "55287900",
        "CardLastFour": "0008",
        "CardHolderName": "Kart Sahibi İsmi",
        "CardNumber": "55287900****0008",
        "Expired": false,
        "CardTypeId": 1,
        "CardType": "Credit",
        "Month": 12,
        "Year": 2030,
        "UniqueCode": "ZtuCwuJWMD+Jqju+ZRnw/X92WNSqFEo97slEjPZD6+5M40L75cT4+g==",
        "Details": {
            "CardBankId": 55,
            "CardBank": "T.HALK BANKASI A.Ş.",
            "CardBrandId": 1,
            "CardBrand": "Master Card",
            "CardFamilyId": 5,
            "CardFamily": "Paraf",
            "CardKindId": 1,
            "CardKind": "Bireysel Kart",
            "CardTypeId": 1,
            "CardType": "Credit"
        }
    }
}