Payment Methods v2

THIS METHOD IS NOT USED IN NEW INTEGRATIONS!

Method Name: Pos_Odeme

This method is to start Nonsecure/3D payment process . (The SanalPOS_ID parameter has been removed.)

The resulting 3D URL will be redirected and your credit card transaction will begin.

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 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 & Taksit & 
Islem_Tutar & Toplam_Tutar & Siparis_ID & Hata_URL & Basarili_URL
Dim Islem_Hash$ = SHA2B64(Islem_Guvenlik_Str)

Calculation of Order Amount Including Commission
Commission 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)
is in the form of.

Parameters to Send:

Parameter Required Type Length Description
G * Object - ST_WS_Guvenlik Object
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 assings new Siparis_ID. As a result of this the Siparis_ID is returned.
Siparis_Aciklama String 250 Description of the order
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_Guvenlik_Tip * String 2 NS(NonSecure) or 3D are sent.
Islem_ID String - Single ID except the Siparis_ID that belongs to transaction optional.
IPAdr * String 50 IP Address
Ref_URL String 256 Url of page where payment is made
Data1 String 256 Extra Space 1
Data2 String 256 Extra Space 2
Data3 String 256 Extra Space 3
Data4 String 256 Extra Space 4
Data5 String 256 Extra Space 5
Data6 String 256 Extra Space 6
Data7 String 256 Extra Space 7
Data8 String 256 Extra Space 8
Data9 String 256 Extra Space 9
Data10 String 256 Extra Space 10

*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: For 3D transactions



<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>İşlem Başarılı
    </Sonuc_Str>

    </ST_TP_Islem_Odem>

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 returns the bank error.

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.

Sample Result Parameters: For Nonsecure Transactions 



<ST_TP_Islem_Odem>
    <Islem_ID>1013521904
    </Islem_ID>

    <UCD_URL>NONSECURE
    </UCD_URL>

    <Sonuc>1
    </Sonuc>

    <Sonuc_Str>İşlem Başarılı
    </Sonuc_Str>

    </ST_TP_Islem_Odem>

If the Sonuc is greater than "0", the 'NONSECURE' equality of UCD_URL is searched. If equal, the transaction ends. The Islem_ID value is the Dekont_No value.
For a successful NonSecure operation, Sonuc > 0, Islem_ID > 0 and UCD_URL = 'NONSECURE'. Otherwise, the transaction is unsuccessful.
If the NONSECURE transaction is incorrect, the Sonuc_Str value returns an error message from the bank. If UCD_URL <> 'NONSECURE', it is treated like a 3D operation.