The method is to start the payment process. The resulting 3D URL will be redirected and your credit card transaction will begin.
Credit Card information for testing:
Card Number: 4444444444444444
Expiration Date Month Day : 04 20
CVV: 444 giriniz.
Calculation of Transaction Hash Value :
The SHA2B64 method of this service hash this value and converts it to Base64String as the value you
pass to the parameter. As in the following example, combine these parameters using the string concatenation method
appropriate to your language and send them to SHA2B64 The result is Islem_Hash
value. Create the parameter formats that will generate the Islem_Hash by looking at the
parameters to be sent table. (Such as Islem_Tutar needs to be comma)
Dim Islem_Guvenlik_Str$ = CLIENT_CODE & GUID & SanalPOS_ID & Taksit &
Islem_Tutar & Toplam_Tutar & Siparis_ID & Hata_URL & Basarili_URL
Dim Islem_Hash$ = SHA2B64(Islem_Guvenlik_Str)
Calculation of Order Amount Including Commission
Comission Ratio: Commission rate of the installment selected from the TP_Ozel_Oran_SK_Liste method
Islem_Tutar: The amount of your order
Toplam_Tutar = Islem_Tutar + ((Islem_Tutar x Komisyon Oran) / 100)
Parameters to Send:
Parameter | Required | Type | Length | Description |
---|---|---|---|---|
G | * | Object | - | ST_WS_Guvenlik Object |
SanalPOS_ID | * | Integer | 4 | SanalPOS_ID value of the card brand chosen by the customer using TP_Ozel_Oran_SK_Liste method |
GUID | * | String | 36 | Key Belonging to Member Workplace |
KK_Sahibi | * | String | 100 | Credit Card Holder |
KK_No | * | String | 16 | Credit Card Number |
KK_SK_Ay | * | String | 2 | 2 digit Expiration month |
KK_SK_Yil | * | String | 4 | 4 digit Expiration Year |
KK_CVC | * | String | 3 | CVC Code |
KK_Sahibi_GSM | * | String | 10 | Credit Card holder GSM No, Without zero at the beginning (5xxxxxxxxx) |
Hata_URL | * | String | 256 | If the payment fails, page address to be redirected to |
Basarili_URL | * | String | 256 | If the payment is successful, page address to be redirected to |
Siparis_ID | * | String | 50 | Singular ID for Order-specific. If you have sent before this value the system is new Assign Siparis_ID. As a result of this Siparis_ID is returned. |
Siparis_Aciklama | String | 250 | Order Description | |
Taksit | * | Integer | 2 | Selected number of installments. Send 1 for one installment. |
Islem_Tutar | * | String | - | Order Amount, (only a comma with Kuruş format 1000,50) |
Toplam_Tutar | * | String | - | Commission Including Order Amount, (only a comma with Kuruş format 1000,50) |
Islem_Hash | * | String | - | Transaction Hash Value |
Islem_ID | String | - | Single ID except the Sipariş Id that belongs to transaction, optional. | |
IPAdr | * | String | 50 | IP Address |
Ref_URL | String | 256 | Url of page where payment is made | |
Data1 | String | 250 | Extra Alan 1 | |
Data2 | String | 250 | Extra Space 2 | |
Data3 | String | 250 | Extra Space 3 | |
Data4 | String | 250 | Extra Space 4 | |
Data5 | String | 250 | Extra Space 5 |
*Non-required fields must be submitted with empty values.
Result Parameters:
Parameter | Type | Length | Description |
---|---|---|---|
Sonuc | Integer | - | The transaction result |
Sonuc_Str | String | - | Transaction result explanation |
Islem_ID | Long | - | SID Value |
UCD_URL | String | - | 3D’s URL |
Banka_Sonuc_Kod | Integer | - | The code returned by bank |
Sample Result Parameters:
<ST_TP_Islem_Odeme xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="https://turkpos.com.tr/">
<Islem_ID>1000611272</Islem_ID>
<UCD_URL>https://turkodeme.com.tr/Tahsilat/3D_Secure/AkilliKart_3DPay_VKF.aspx?rURL=TURKPOS_3D_TRAN&SID=1</UCD_URL>
<Sonuc>1</Sonuc>
<Sonuc_Str>Process Successfull</Sonuc_Str>
</ST_TP_Islem_Odeme>
If the Result parameter you will get from the ST_TP_Islem_Odeme object is greater than "0", redirect to the UCD_URL parameter to initiate the 3D Secure Payment transaction. In case of successful or unsuccessful payment by credit card, Hata_URL or Basarili_URL will be posted.
POST Parameters:
Parameter | Description |
---|---|
TURKPOS_RETVAL_Sonuc | The transaction result |
TURKPOS_RETVAL_Sonuc_Str | Transaction result explanation |
TURKPOS_RETVAL_GUID | Key Belonging to Member Workplace |
TURKPOS_RETVAL_Islem_Tarih | Transaction Date |
TURKPOS_RETVAL_Dekont_ID | Receipt Number |
TURKPOS_RETVAL_Tahsilat_Tutari | Amount collected from the customer |
TURKPOS_RETVAL_Odeme_Tutari | Net amount. The amount of the commission is deducted from the collection amount. |
TURKPOS_RETVAL_Siparis_ID | Siparis_ID which belongs to the transaction that we sent the service |
TURKPOS_RETVAL_Islem_ID | Islem_ID that we sent the service |
TURKPOS_RETVAL_Ext_Data | In method Data1, Data2, Data3, Data4, Data5 parameters combined with “|” returns. Ext_Data = Data1 & "|" & Data2 & "|" & Data3 & "|" & Data4 & "|" & Data5 |
TURKPOS_RETVAL_Banka_Sonuc_Kod | The code returned by bank |
If TURKPOS_RETVAL_Sonuc <0, TURKPOS_RETVAL_Dekont_ID returns "0". If the value of TURKPOS_RETVAL_Dekont_ID is greater than "0", it means that the credit card transaction has been completed.