🔐Üye İş Yeri Doğrulama

Entegrasyon süresine başlamak için üye işyerleri kullanıcılar tarafından çağırılacak. Üye işyeri tanımı yapılırken API kullanıcısına ait E-mail ve Mobil Cep Telefonuna gelen API Key güvenliği için client side post olmayacaktır. Şifrenin güvenliği üye işyerinin sorumluğunda olup ; tarafımızda hashlı tutulup herhangi bir şekilde tekrardan API key talebinde bulunamayacaktır. Operasyon ekiplerimize iletilen talebe istinaden portal üzerinden şifre yenileme talebinde bulunabilirsiniz.

Tüm ödeme servislerimizde Bearer token alımı gereklidir. Bearer token ile kimlik doğrulanması sağlanmış olup ödeme web servislerine erişim sağlanır. Her token in geçerlilik süresi 4 saattir ve geçerliliğini koruyana kadar aynı token in kullanılması önem arz etmektedir. Bearer’ ın kullanım süresi bitince ”HttpStatusCode. Unauthorized” (401) status code alınır.

URL

POST https://testahlsanalpos.ahlpay.com.tr/api/Security/AuthenticationMerchant

Servise gönderilen parametreler şu şekildedir:

Parametre	Tip	Açıklama
password*	string	Üye işyeri tarafından iletilen API kullanıcısının email ya da mobil telefonuna iletilen şifre bilgisidir.
email*	string	Üye işyeri tarafından iletilen API kullanıcısının email bilgisidir.

Servisten dönen parametreler şu şekildedir:

Parametre	Tip	Açıklama
isSuccess	boolean	İşlem başarılı (true) ; işlem başarısız (false) bilgisi döner
phoneNumber	string	Üye işyerine ait api kullanısının sistemde tanımlı olan mobil telefon numarasıdır. Maskeli döner.
fullName	string	Üye işyerine ait api kullanısının isim ve soyad bilgisini döner.
expireDate	datetime	Token in geçerlilik süresidir. YYYY-mm_DDTHH:mm:ss formatında dönecektir.
tokenType	string	Servisten dönen token tipi bilgisidir.
token	string	Servisten dönen size özel token bilgisidir.
data	array	Dizi olarak aşağıdaki parametreler dönmektedir
requestId	string	Sistem tarafından isteğe ait unique ID bilgisidir.
errorCode	int	isSuccess: true olması durumunda null ; false olması durumunda alınan hata codu gelmektedir.
message	string	isSuccess: true olması durumunda "İşlem başarılıdır." ; false olması durumunda alınan hata mesajı gelmektedir.
email	string	Api kullanıcısın tanımlandığı email bilgisidir.
merchantID	string	Api kullanıcısın tanımlandığı üye işyeri numarasıdır
merchantName	string	Api kullanıcısın tanımlandığı üye işyeri adı
sessionId	string	Token in geçerli olduğu session ID değerini döner.
masterPassDefinition	boolean	Üye işyerinin Masterpass entegrasyonu var ise (true) yok ise (false) dönmektedir.
systemPassword	boolean	Sistem tarafından belirlenen şifre değiştirilmediyse true; şifre değiştirme yapıldıysa false dönmektedir. Şifre değişiklikleri backoffice tarafından yapılmaktadır. API kullanıcısında bu alan her zaman true olacağından şifre değişiklikleri olmayacaktır. Sistemden tanımlanan hash li password bilgisidir.

İstek

  
{
  "email": "[e-mail]",
  "password": "AHLPAY01."
}
  

Cevap

  
{
    "isSuccess": true,
    "message": "İşlem başarılıdır.",
    "errorCode": null,
    "requestId": "8645df5d-abec-47f9-968b-3cee2de5cca2",
    "data": {
        "token": "eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJlbWFpbCI6IkNXTkN3bTloNDdLNTROVVpSUFJNM3Y2bFZpWklTMjRpTVlQWHFXZWxINm89IiwidW5pcXVlX25hbWUiOiJhSnV6L1B3ajRlK3A1bTdKVnc0Y1h3PT0iLCJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9zaWQiOiJ5aFZRUzNNNzRDcUlETUlYeUVIWUFBPT0iLCJodHRwOi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3dzLzIwMDgvMDYvaWRlbnRpdHkvY2xhaW1zL2V4cGlyZWQiOiJ0bXNYQVMxbVpCdnd0bUhlQ0VjSDY4VFBzOUYrb0t1dERGME1VSzVCa1k4PSIsIlNlc3Npb25JZCI6ImUxYTZPSFBBbTdqZFVkUmVuYkhaVjB2V0tzV3lEd1ZJenZLOWVDT0N0T1JvZDJKQUVoRTBSbjZPSUt5bVpKR2oiLCJSb2xlcyI6IjdtWkhQcTNTNlhuQ3FWU3lYVVNuZ0d4WWhEQ0sxOVlpcUtKSEozZ0ZqVUpPOFk0WnRHNi93SUtHaTNlSUVxWnk1N0JZRVh0SW5rTGpLZ0dBT29KRGl0WCtJN28vSmxUSE9IdklYc2pJcC9BR2lKMzJRVUg2WTlnb2JDS0tVc3FJNzUwSnJjTHJMS3NEMGpGUWNKTmVzL0pPaXR5RFFjaFBPOGdDaUJuZTlhRlFjWG9KQTR4V3R1bmFOVE5MSEVzSEgwbnBKbDhjdUhReXhxKy9mdmE1U2k3czlzYWNOWW5sVFV6RE10eXZkS2h0UEllaGJFWU1PMmZpNWM5eXVqUHFkRzdhKy9xemR0cTcyNkVRUE4vZWFxTG5DNHMyWmlIVnJGaFYxVGIwUWIxeEp1eWdKbkIyZW45Mk5sKzgrYkZ6bHdVU2ZxY0hYRjR4SDI4dm9WWFZSZz09IiwiU3lzdGVtUGFzc3dvcmQiOiJ2bWdTNXl6Z05XOSt1alM0NjNnRmtBPT0iLCJuYmYiOjE2ODA3MTczNjYsImV4cCI6MTY4MDcyOTQyNiwiaWF0IjoxNjgwNzE3MzY2LCJpc3MiOiJsb2NhbC1wM3NwZy5jb20udHIiLCJhdWQiOiJsb2NhbC1wM3NwZy5jb20udHIifQ.JTE0hfHm8vR2VEUdZ0--5cyUF9XNFHQ0QxDNBYYKnueol7TvhY1mIOQyVTMTF-j_giGrnF1Y1U8tPgnk16DMXA",
        "tokenType": "Bearer",
        "expireDate": "2023-04-05T21:17:06.165265Z",
        "fullName": "ASIM GÜLER",
        "phoneNumber": "537****35",
        "sessionId": "707a0d1c-ac46-407a-b596-048347c3e110",
        "merchantName": "AHL PAY.",
        "merchantId": 97163,
        "email": "[e-mail]",
        "systemPassword": false
        "masterPassDefinition": true
    }
}