11. Ödeme Doğrula (Otp)

Masterpass üzerinden gerçekleştirilen ve Otp doğrulaması gerektiren ödemeler, bu servis üzerinden yapılabilmektedir

Ödeme Doğrula (Otp)

POST {{Base Address}}/api/paywall/masterpass/payment/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 - Ödeme Doğrula (Otp) 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
SessionId	Guid	Evet	Oturum Kimliği bilgisi
MasterpassPaymentId	Guid	Evet	Ödeme başlatma anında Paywall servislerinden dönen cevap içerisinde yer almaktadır
OtpToken	string	Evet	Ödeme Başlat servisinden ilgili değer, eğer ödeme Otp ile ilerletilmesi gerekiyorsa dönmektedir
OtpCode	string	Evet	Kullanıcıdan ödeme ekranında alınan doğrulama kodu bilgisidir

Json

{
    "OtpToken": "f6b4401774f544dc8ec958dbe7a8470f",
    "OtpCode": "123456",
    "SessionId": "5895433e-f36b-1410-825e-001264113a90",
    "MasterpassPaymentId": "ce55004d-888c-416f-84d7-ed2873531fe7"
}

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.

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
        }
    }
}