Get Installments
When the installment inquiry service is used, the amounts to be paid for installment and single-payment transactions for card families are returned. The amount sent to this service should be used along with the payable_amount
and installment
parameters. It should be called after entering the first 6 digits of the card on the payment page. The returned response is used to display installment options to the user.
If the payable_amount
parameter is the same as the requested amount, the end-user's commission is covered by the merchant.
Method |
API Endpoint |
Content-Type |
POST |
/api/getpos |
application/json |
Parameter |
Requirement |
Content-Type |
Authorization |
Mandatory |
Bearer |
Accept |
Mandatory |
application/json |
Parameter |
Data Type |
Requirement |
Description |
credit_card |
digit |
Mandatory |
Card number. |
amount |
double |
Mandatory |
Total product amount 1000.44 . |
currency_code |
string |
Mandatory |
Currency code USD / TRY / EUR . |
merchant_key |
string |
Mandatory |
Unique Merchant Key obtained through PayBull. |
EXAMPLE CODES
{
"credit_card": "540669",
"amount": "100",
"currency_code": "TRY",
"merchant_key": "$2y$10$w/ODdbTmfubcbUCUq/ia3OoJFMUmkM1UVNBiIQIuLfUlPmaLUT1he"
}
{
"status_code": 100,
"status_description": "Successfull",
"data": [
{
"pos_id": 207,
"campaign_id": 0,
"allocation_id": 0,
"installments_number": 1,
"card_type": "CREDIT CARD",
"card_program": "BONUS",
"card_scheme": "mastercard",
"payable_amount": 101.5,
"hash_key": "9a45197facc99fb0:0b24:OLmydowA7bJFFDgFKIrVz5gWfbt6B7aB44Y0FJUEtiWKHMVHA7d59T0CWYQ9epEjoIks9EkKt8rWPSi__RC5E2doW9VaHR1KZbtABE__uHLm4=",
"amount_to_be_paid": "101.50",
"currency_code": "TRY",
"currency_id": 1,
"title": "Single payment"
},
{
"pos_id": 207,
"campaign_id": 0,
"allocation_id": 0,
"installments_number": 2,
"card_type": "CREDIT CARD",
"card_program": "BONUS",
"card_scheme": "mastercard",
"payable_amount": 102.5,
"hash_key": "e05591740b77335d:4cba:ugD+T__lwf0T4IZ0JAOVQNf2ZR4yyXlOkArjH1mHO8GojItqElxsxbIuLJAaaq7QKpkK__VQdZcjzsO5hZbvTyDLVQzYvx5KJTTSRsKXiyx0I=",
"amount_to_be_paid": "102.50",
"currency_code": "TRY",
"currency_id": 1,
"title": 2
}
]
}
{
"status_code": 40,
"status_description": "installment not found"
}