1. Oturum Oluştur

Paywall üzerinden Masterpass servislerini kullanmaya başlamadan önce, ilgili kullanıcının bilgileriyle bir Masterpass oturumu oluşturmanız gerekmektedir.

Oturum Oluştur

POST {{Base Address}}/api/paywall/masterpass/session

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 - Oturum Oluştur 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
ReferenceCode	string	Evet	İlgili oturumun tekil takip numarası
UserId	string	Evet	Ödeme ekranındaki kullanıcının sisteminizdeki tekil kimlik numarası
UserPhone	string	Evet	Ödeme ekranındaki kullanıcının doğrulanmış telefon numarası
Force3D	bool	Hayır	İlgili parametrenin true gönderilmesi durumunda, tüm ödeme süreçleri 3D olarak ilerleyecektir
PhoneVerifiedByMerchant	bool	Hayır	İlgili telefon numarasını sisteminizde doğruladıysanız, bu parametre true olarak gönderilmelidir. Böylece Masterpass, telefon numarası doğrulamasını tekrar yapmaz

Json

{
    "ReferenceCode": "{{$guid}}",
    "UserId": "72812393211", // Kullanıcının sisteminizdeki tekil kimlik bilgisi
    "UserPhone": "905123456710", // Kullanıcının sisteminizdeki doğrulanmış telefon numarası
    "Force3D": false, // Kullanıcı tüm ödeme akışında 3D'ye zorlansın mı?
    "PhoneVerifiedByMerchant": true // Telefon doğrulaması yapıldı mı?
}

C#

GO

Java

PHP

Python

Ruby

TypeScript

Curl

Servisten dönen cevap:

Parametre	Tip	Açılama
Body	Body	Ö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.

Servisten dönen cevap (Body):

Parametre	Tip	Açılama
SessionId	Guid	İlgili oturumun kimlik bilgisidir. Tüm süreçte yetkilendirme için kullanılmaktadır. Bu bilgi süreç tamamlanana kadar tarafınızda saklanmalıdır
SessionExpiryDate	DateTime	Oturumun son kullanılma tarihidir. Otomatik olarak yenilendiğinde diğer Masterpass servislerinin cevap nesneleri içinde yeni SessionId ve yeni SessionExpiryDate bilgileri dönmektedir

Json

{
    "ErrorCodeType": 1,
    "ErrorMessage": null,
    "ErrorCode": 0,
    "Result": true,
    "Message": "",
    "Body": {
        "SessionId": "9b27433e-f36b-1410-80e5-004205aa382d",
        "SessionExpiryDate": "2025-07-27T11:24:57"
    }
}