Payment Methods

Method Name: TP_Islem_Odeme

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.

Transaction Hash Value Calculation:
The SHA2B64 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 isIslem_Hash value. Create the parameter formats that will generate the Process_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: TP_Ozel_Oran_SK_Liste The commission rate payment method selected from installment.
Islem_Tutar: The amount of your order
Toplam_Tutar = Islem_Tutar + ((Islem_Tutar x Komisyon Oran) / 100)

Parameters to Send:

Parameter Type Length Description
G NS - ST_WS_Guvenlik Object
SanalPOS_ID I 4 TP_Ozel_Oran_SK_LIST is the VirtualPOS_ID value of the Card Brand selected from the customer method.
GUID N 36 Key Belonging to Member Workplace
KK_Sahibi N 100 Credit Card Holder
KK_No N 16 Credit Card Number
KK_SK_Ay N 2 Last 2 digit Expiration month
KK_SK_Yil N 4 4 digit Expiration Year
KK_CVC N 3 CVC Code
KK_Sahibi_GSM N 10 Credit Card holder GSM No, Without zero at the beginning (5xxxxxxxxx)
Hata_URL N 256 If the payment fails, page address to be redirected to
Basarili_URL N 256 If the payment is successful, page address to be redirected to
Siparis_ID N 50 Singular ID for Order-specific. If you have sent before this value the system is new Assign order_ID. As a result of this The order_ID is returned.
Siparis_Aciklama N 250 Order Description
Taksit I 2 Selected number of installments. Send 1 for one installment.
Islem_Tutar N - Order Amount, (only a comma with Kuruş format 1000,50)
Toplam_Tutar N - Commission Including Order Amount, (only a comma with Kuruş format 1000,50)
Islem_Hash N - Transaction Hash Value
Islem_ID N - Single ID except the Sipariş Id that belongs to transaction, optional.
IPAdr N 50 IP Address
Ref_URL N 256 Url of page where payment is made
Data1 N 250 Extra Alan 1
Data2 N 250 Extra Space 2
Data3 N 250 Extra Space 3
Data4 N 250 Extra Space 4
Data5 N 250 Extra Space 5

Result Parameters:

Parameter Type Length Description
Sonuc N - The transaction result
Sonuc_Str N - Transaction result explanation
Islem_ID L - SID Value
UCD_URL N - 3D’s URL

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>

From the ST_TP_Islem_Operation object If the Result parameter 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, HATE_URL or Successful_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

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.