3. Kart Ekle

Kullanıcınızın Masterpass'e kart eklemesi için bu servisi kullanabilirsiniz

Kart Ekle

POST {{Base Address}}/api/paywall/masterpass/card/add

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: Masterpass - Kart Ekle servisini kullanabilmeniz için 'Header' alanında 'apikeyprivate' ve 'apiclientprivate' parametrelerini göndermeniz gerekmektedir. PaymentAPI Adresi

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 parametreler şu şekildedir:

Parametre	Tip	Zorunlu	Açıklama
CardAlias	string	Evet	Karta kullanıcı tarafından verilmiş olan takma ad
CardHolderName	string	Evet	Kart sahibinin ismi
CardNumber	string	Evet	Kart numarası
ExpiryMonth	string	Evet	Kart son kullanma - Ay
ExpiryYear	string	Evet	Kart son kullanma - Yıl
Cvv	string	Evet	Kart CVV bilgisi
SessionId	Guid	Evet	Oturum Kimliği bilgisi

Json

{
    "CardAlias": "{{$guid}}",
    "CardHolderName": "Kart Sahibi Adı",
    "CardNumber": "5528790000000008",
    "ExpiryMonth": "12",
    "ExpiryYear": "2030",
    "Cvv": "123",
    "SessionId": "2193433e-f36b-1410-825e-001264113a90"
}

C#

// Soon

GO

// Soon

Java

// Soon

PHP

// Soon

Python

// Soon

Ruby

// Soon

TypeScript

// Soon

Curl

// Soon

Servisten dönen cevap:

Parametre	Tip	Açılama
Body	object	Ödemeye ilişkin detay içeren JSON (opsiyonel)
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 > Masterpass > Result > StatusCode ve Body > Masterpass > Result > ResponseCode dizini altındaki parametre kontrol edilerek akış kurulmalıdır

• Masterpass ResponseCode Listesi

Başarılı ✅

{
    "ErrorCodeType": 1,
    "ErrorMessage": null,
    "ErrorCode": 0,
    "Result": true,
    "Message": "",
    "Body": {
        "Session": {
            "SessionRenewed": false,
            "SessionId": "a327433e-f36b-1410-80e5-004205aa382d"
        },
        "Masterpass": {
            "Result": {
                "RetrievalReferenceNumber": "100005844108",
                "ResponseCode": "5001",
                "Description": "Telefonunuza gelen tek kullanımlık şifreyi girerek kart doğrulama işlemini tamamlayınız",
                "Token": "7e6db5a88fe248ada3d20adc493035e4",
                "Url3d": null,
                "Url3dSuccess": null,
                "Url3dFail": null
            },
            "BuildId": "83",
            "CorrelationId": "7c18d334-2dc3-4ed6-931f-1ae16c4a2886",
            "Exception": null,
            "Message": "Accepted",
            "RequestId": null,
            "StatusCode": 202,
            "Version": null
        }
    }
}

Başarısız ❌

{
    "ErrorCodeType": 1,
    "ErrorMessage": null,
    "ErrorCode": 0,
    "Result": true,
    "Message": "",
    "Body": {
        "Session": {
            "SessionRenewed": false,
            "SessionId": "a327433e-f36b-1410-80e5-004205aa382d"
        },
        "Masterpass": {
            "Result": null,
            "BuildId": "83",
            "CorrelationId": null,
            "Exception": {
                "Level": "Warning",
                "Code": "CARD_ALREADY_EXISTS",
                "Message": "Kart zaten mevcut."
            },
            "Message": "BadRequest",
            "RequestId": null,
            "StatusCode": 400,
            "Version": null
        }
    }
}