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.

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.