5. Otp Doğrula

Masterpass Otp süreçlerini bu servis ile doğrulabilirsiniz

Otp Doğrula

POST {{Base Address}}/api/paywall/masterpass/otp/verify

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 - Otp Doğrula 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
OtpToken	string	Evet	Otp gerektiren işlem anında API'den cevap parametreleri içerisinde yer alır Masterpass > Result > Token
OtpCode	string	Evet	Ekranda kullanıcıdan aldığınız Otp kodu
ForLinkToMerchant	bool	Hayır	Eğer kullanıcı ile üye işyeri şirket arasındaki bağlantının kurulabilmesi için OTP doğrulaması yapılıyorsa, bu parametre true gönderilmelidir
SessionId	Guid	Evet	Oturum Kimliği bilgisi

Json

{
    "OtpToken": "88599362e05441458c1efa588a711c8f",
    "OtpCode": "123456",
    "ForLinkToMerchant": false,
    "SessionId": "5095433e-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": "a527433e-f36b-1410-80e5-004205aa382d"
        },
        "Masterpass": {
            "Result": {
                "RetrievalReferenceNumber": "100005844112",
                "IsVerified": true,
                "Url3d": null,
                "Url3dSuccess": null,
                "Url3dFail": null,
                "CardUniqueNumber": "382C4D4AA6AA93C7CF2D613BB144AA6305A46FDCD40B795C40B97A486D8E2BE2",
                "Token": "057227d485424da0a3394056b8c21bdc",
                "ResponseCode": "0000",
                "Description": "OTP verified successfully."
            },
            "BuildId": "78",
            "CorrelationId": "6ba60890-6f0e-479d-8987-c1cfd4cf4abc",
            "Exception": null,
            "Message": "OK",
            "RequestId": null,
            "StatusCode": 200,
            "Version": null
        }
    }
}

Başarısız ❌

{
    "ErrorCodeType": 1,
    "ErrorMessage": null,
    "ErrorCode": 1,
    "Result": false,
    "Message": "",
    "Body": {
        "Session": {
            "SessionRenewed": true,
            "SessionId": "a527433e-f36b-1410-80e5-004205aa382d"
        },
        "Masterpass": {
            "Result": null,
            "BuildId": "78",
            "CorrelationId": null,
            "Exception": {
                "Level": "Unauthorized",
                "Code": "TOKEN_HAS_EXPIRED",
                "Message": "Tokenın süresi doldu."
            },
            "Message": "Unauthorized",
            "RequestId": null,
            "StatusCode": 401,
            "Version": null
        }
    }
}