Bilgilendirme

Taksit Sorgulama Servisi Nedir?

Taksit sorgulama servisi, kart BIN bilgisi ile taksit seçeneklerinin sorgulanmasını sağlayan sistemdir.

NOT!

Bu servis ile sadece taksit komisyon oranları sorgulanmaktadır.

Servisi çağırmadan önce Access Token almanız gerekmekte ve aldığınız bu token ile servisi çağırmanız gerekmektedir.

Access Token Nasıl Alabilirim?

Prod Url	:	https://api.hepsipay.com/oauth/token
Test Url	:	https://apientgr.hepsipay.com/oauth/token
HTTP Method	:	POST
Header value	:	Content-Type: application/x-www-form-urlencoded; Authorization = Basic Base64(ClientId+:+ClientSecret)
Body:	:	grant_type = password

Token için verilen Url adreslerine POST metodu kullanarak bir istek yapmanız gerekmektedir. Header bilgisi olarak Content-Type: application/x-www-form-urlencoded; ve Authorization = Basic Base64(ClientId+:+ClientSecret) göndermelisiniz.

ClientId ve ClientSecret Base 64 ile şifrelenmesi

Kullanıcı adı ve parolasıyla doğrulama yapılır ve access token alınır. Kullanıcı adı “ClientId” ve kullanıcı parolası “ClientSecret” olarak tanımlanmıştır ve zorunlu parametrelerdir. ClientId ve ClientSecret bilgisi string birleştirilir. Bu birleştirilen bilgileri Base64 ile encode edilerek HTTP Basic Authorization olarak headerda yollanır. ClientId ve Clientsecret encode edilirken aralarına ":" karakteri koyulmalıdır.

ClientId parametresi yerine ApiKey ve ClientSecret yerine SecretKey bilgilerini kullanmalısınız.

Hesapladığınız header bilgileri ve x-www-form-urlencoded şeklinde grant_type=password gönderimi ile istek yapabilirsiniz.

NOT!

Aşağıdaki adresten Postman isteğini import edebilirsiniz:

https://www.getpostman.com/collections/ac81fdbb30f335d7d579

NOT!

Postman uygulamasını Chrome üzerinden eklenti olarak yüklemeyen üye işyerlerimiz yukarıdaki linke ulaşamamaktadır.

Bu üye işyerlerimiz buraya tıklayarak txt dosyası halinde indirip Postmane import etmelidir.

Postman ile yapılmış bir örnek AccessToken isteği:

Header parametreleri:

Body:

Access Token Cevabı:


{ 
"access_token": "XXXXYYYZZZ", 
"token_type": "bearer", 
"expires_in": 43199
}

Örnek Postman cevabı:

Taksit Sorgulama Web Servisi

Prod Url	:	https://api.hepsipay.com/merchants/installments
Test Url	:	https://apientgr.hepsipay.com/merchants/installments
HTTP Method	:	POST
Headers	:	Content-Type: application/json Authorization: Bearer <Access Token>

AccessToken için yaptığınız istek cevabında dönen access_token alanında gönderilen değeri, taksit sorgulama servisinde Header kısmında Authorization: Bearer access_token(aldığınız değer) olarak göndermeniz gerekmektedir.

Örnek Postman isteği:

Header bilgisi:

Body bilgisi:

Web Servis İsteği


{
  "ApiKey": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJyb2xlIjoxLCJBcGlLZXkiOiI4NjRjYWJlMjk4Nzk0MTc1OGE2NjNlOTgzNjRjNjVmMSJ9.arVhSLZglydFDIUKz-UlNQrMMM7bQdNlSXM8o0dzGWE",
  "BinNumber": 428220,
  "Amount": 10000
}

Web Servis Cevabı


{
  "InstallmentDtos": [
    {
      "Amount": 10000,
      "CalculatedAmount": 10000,
      "BankName": "Garanti",
      "BankId": 0,
      "Installment": 1,
      "Commission": 1.01
    },
    {
      "Amount": 10000,
      "CalculatedAmount": 10102,
      "BankName": "Garanti",
      "BankId": 0,
      "Installment": 2,
      "Commission": 1.02
    },
    {
      "Amount": 10000,
      "CalculatedAmount": 10103,
      "BankName": "Garanti",
      "BankId": 0,
      "Installment": 3,
      "Commission": 1.03
    },
    {
      "Amount": 10000,
      "CalculatedAmount": 10104,
      "BankName": "Garanti",
      "BankId": 0,
      "Installment": 4,
      "Commission": 1.04
    },
    {
      "Amount": 10000,
      "CalculatedAmount": 10105,
      "BankName": "Garanti",
      "BankId": 0,
      "Installment": 5,
      "Commission": 1.05
    },
    {
      "Amount": 10000,
      "CalculatedAmount": 10106,
      "BankName": "Garanti",
      "BankId": 0,
      "Installment": 6,
      "Commission": 1.06
    },
    {
      "Amount": 10000,
      "CalculatedAmount": 10107,
      "BankName": "Garanti",
      "BankId": 0,
      "Installment": 7,
      "Commission": 1.07
    },
    {
      "Amount": 10000,
      "CalculatedAmount": 10108,
      "BankName": "Garanti",
      "BankId": 0,
      "Installment": 8,
      "Commission": 1.08
    },
    {
      "Amount": 10000,
      "CalculatedAmount": 10109,
      "BankName": "Garanti",
      "BankId": 0,
      "Installment": 9,
      "Commission": 1.09
    },
    {
      "Amount": 10000,
      "CalculatedAmount": 10110,
      "BankName": "Garanti",
      "BankId": 0,
      "Installment": 10,
      "Commission": 1.1
    },
    {
      "Amount": 10000,
      "CalculatedAmount": 10111,
      "BankName": "Garanti",
      "BankId": 0,
      "Installment": 11,
      "Commission": 1.11
    },
    {
      "Amount": 10000,
      "CalculatedAmount": 10112,
      "BankName": "Garanti",
      "BankId": 0,
      "Installment": 12,
      "Commission": 1.12
    }
  ],
  "Success": true,
  "MessageCode": "0000",
  "Message": "Başarılı",
  "UserMessage": "İşleminiz başarıyla gerçekleşmiştir."
}