The virtual pos rates given by the company to the merchant are listed. Merchant can make changes on these rates (Company Pos Rates).
Parameter | Required | Type | Length | Description |
---|---|---|---|---|
G | Yes | Object | - | ST_WS_Guvenlik Object |
GUID | Yes | String | 36 | Merchant Key of the Member Merchant |
Parameter | Type | Length | Description |
---|---|---|---|
Sonuc | Integer | - | Transaction result |
Sonuc_Str | String | - | Transaction result description |
DT_Bilgi | Object | - | Virtual POS rate list |
Informatipn : MO_x : Member Merchant Ratio
DT_Bilgi Object
Parameter | Type | Length | Description |
---|---|---|---|
Ozel_Oran_ID | Long | - | Special Rate ID |
GUID | String | 36 | Merchant's Key |
Tarih_Bas | String | 10 | Start date for special rates (e.g., dd.MM.yyyy) |
Tarih_Bit | String | 10 | End date for special rates (e.g., dd.MM.yyyy) |
SanalPOS_ID | Integer | 4 | Virtual POS number |
Kredi_Karti_Banka | String | 20 | Credit Card Brand (Bonus, Axess, etc.) |
Kredi_Karti_Banka_Gorsel | String | - | Credit Card Brand Image |
MO_01 | String | - | Single Payment Rate |
MO_02 | String | - | 2 Installment Rate |
MO_03 | String | - | 3 Installment Rate |
MO_04 | String | - | 4 Installment Rate |
MO_05 | String | - | 5 Installment Rate |
MO_06 | String | - | 6 Installment Rate |
MO_07 | String | - | 7 Installment Rate |
MO_08 | String | - | 8 Installment Rate |
MO_09 | String | - | 9 Installment Rate |
MO_10 | String | - | 10 Installment Rate |
MO_11 | String | - | 11 Installment Rate |
MO_12 | String | - | 12 Installment Rate |
If any installment rate is -1 or -2, in other words, if it is less than “0”, this installment option cannot be used for that credit card brand.
If you receive the Response_Code parameter from the ST_TP_Islem_Odeme_BKM object and it is greater than "0", redirect to the Redirect_URL parameter to initiate the payment process with BKM Express. Depending on whether the transaction is successful or unsuccessful, POST will be provided to the Hata_URL or Basarili_URL values.
The special rate for end-user list returns the same rates as those returned by the method in the "Company POS Rates" by default. It lists the commission rates that the merchant will show to its customers.
For example, suppose a company offers a commission rate of 3.15% for 3 installments using an Axess credit card. The merchant believes this rate is too high for its customers and decides to update this commission rate to 2.50% using the `TP_Ozel_Oran_SK_Guncelle` method. When a customer proceeds to make a payment on the merchant's website, they see the installment commission rate as 2.50% and complete the payment. The company collects 2.50% from the customer and charges the merchant the difference of 0.65% between the two rates.
Parameter | Required | Type | Length | Description |
---|---|---|---|---|
G | Yes | Object | - | ST_WS_Guvenlik Object |
GUID | Yes | String | 36 | Merchant's Key |
Parameter | Type | Length | Description |
---|---|---|---|
Sonuc | Integer | - | Transaction result |
Sonuc_Str | Object | - | Transaction result description |
DT_Bilgi | Object | - | Virtual POS rate list |
DT_Bİlgi Object
Parameter | Type | Length | Description |
---|---|---|---|
Ozel_Oran_SK_ID | Long | - | Special Rate ID from the SK List |
GUID | String | 36 | Merchant's Key |
SanalPOS_ID | Integer | 4 | Virtual POS number |
Kredi_Karti_Banka | String | 20 | Credit Card Brand (Bonus, Axess, etc.) |
Kredi_Karti_Banka_Gorsel | String | - | Credit Card Brand Image |
MO_01 | String | - | Single Payment Rate |
MO_02 | String | - | 2 Installment Rate |
MO_03 | String | - | 3 Installment Rate |
MO_04 | String | - | 4 Installment Rate |
MO_05 | String | - | 5 Installment Rate |
MO_06 | String | - | 6 Installment Rate |
MO_07 | String | - | 7 Installment Rate |
MO_08 | String | - | 8 Installment Rate |
MO_09 | String | - | 9 Installment Rate |
MO_10 | String | - | 10 Installment Rate |
MO_11 | String | - | 11 Installment Rate |
MO_12 | String | - | 12 Installment Rate |
It is intended for the merchant to show its customer a commission rate lower than the commission rates provided by the Company. This commission rate can be ≤ (less than or equal to) the commission rate given by the Company to the merchant. If the difference between the two commission rates is greater than "0", the merchant covers this difference.
(e.g., User POS Rates / 2nd paragraph)
All parameters are mandatory. For installment parameters where the commission rate is desired to remain the same, a value of “100” is sent. If no installment option is desired, “-1” is sent. Any installment rate of -1 or -2, in other words, less than "0", means that this installment option cannot be used for that card brand.
Send ratios with commas. For example 1,25
Parameter | Required | Type | Length | Description |
---|---|---|---|---|
G | Yes | Object | - | ST_WS_Security Object |
Ozel_Oran_SK_ID | Yes | Long | - | ID returned from the Ozel_Oran_SK_List |
GUID | Yes | String | 36 | Merchant's Key |
MO_1 | No | String | - | Single Payment Rate |
MO_2 | No | String | - | 2 Installment Rate |
MO_3 | No | String | - | 3 Installment Rate |
MO_4 | No | String | - | 4 Installment Rate |
MO_5 | No | String | - | 5 Installment Rate |
MO_6 | No | String | - | 6 Installment Rate |
MO_7 | No | String | - | 7 Installment Rate |
MO_8 | No | String | - | 8 Installment Rate |
MO_9 | No | String | - | 9 Installment Rate |
MO_10 | No | String | - | 10 Installment Rate |
MO_11 | No | String | - | 11 Installment Rate |
MO_12 | No | String | - | 12 Installment Rate |
Parameter | Type | Length | Description |
---|---|---|---|
Sonuc | String | - | Operation result |
Sonuc_Str | String | - | Operation result description |