TR EN


Installments/Commissions



To do Sale transaction with installments, you need to know the available installments list with bank_id, gateway, commission rate for each installment inside Payfull


Request parameters
merchant: required
merchant name which you created in your Payfull account.

type: required
transaction type should be Get.

get_param: required
The name of the parameter you like to get, so it should be Installments.

language: required
Response message language can be en / tr

client_ip: required
The client IP who uses the application which sends the request to the API.

one_shot_commission: optional
Set this parameters to 1 to get only one shot [commission/support 3D] in response.

hash: required
Generated hash code on the caller side

To generate the hash code please follow the steps below:
  • - arrange the parameters alphabetically from A to Z
  • - Create a parameters string which has the length for each parameters with its value side by side
  • - Create the sha256 hash code from the parameters string and pass the merchant password as Shared secret key
  • - Add the hash code to the request parameters





bank_id values of banks and payment institutions are as follows.




Garanti
Akbank
Finansbank
Isbank
Halkbank
HSBC
Denizbank
YapiKredi
Vakifbank
KuveytTurk
Asya
Sekerbank
Teb
Turkiyefinans
Albaraka
ING
Aktifbank
Ziraat
Anadolu





The gateway values for determining the corresponding banks according to the payment method are as follows.




BKMExpress : 210
Compay : 260
Hepsipay : 220
PayU : 160
Moka : 250
Iyzico : 150
Doğrudan Banka : 10001
Param : 310
Paytrek : 300
Paytr Banka : 300


Sample request


merchant: merchant name
type: Get
get_param: Installments
language: tr
client_ip: 192.168.1.1
hash: 14339MjuG01015018



Sample Response


{
"status":1,
"ErrorMSG":"",
"ErrorCode":"00",
"data":
[{
  "bank":"KuveytTurk",
  "gateway":"10001",
  "installments":[{"count":2,"commission":"0%"},{"count":3,"commission":"0%"}],
  "has3d":1,
  "image":"https://dev.payfull.com/sites/all/themes/payfull_theme/design/assets/admin/scripts/card/img/networks/KuveytTurk.png"
},
{
  "bank":"Akbank",
  "gateway":"10001",
  "installments":[{"count":3,"commission":"5%"},{"count":4,"commission":"1%"}],
  "has3d":0,
  "image":"https://dev.payfull.com/sites/all/themes/payfull_theme/design/assets/admin/scripts/card/img/networks/Akbank.png"
}]
}


PHP Example