Nonsecure/3D Payment

Method Name: TP_Islem_Odeme_WNS

The method is to start the Nonsecure / 3D payment process.

Redirect to the 3D URL returned by the operation and payment process begins with a credit card.

Provided that the explanations in method TP_Islem_Odeme are valid.

Parameters to Send:

Parameter Required Type Length Description
G * Object - T_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 assings new Siparis_ID. As a result of this the 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_Guvenlik_Tip * String 2 NS (NonSecure) or 3D are sent.
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 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

*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 transaction 3D

<ST_TP_Islem_Odeme xmlns:xsi="" xmlns:xsd="" xmlns=">
<UCD_URL> AkilliKart_3DPay_VKF. aspx?rURL=TURKPOS_3D_TRAN&SID=1 </UCD_URL>
<Sonuc>1 </Sonuc>
<Sonuc_Str>İşlem Başarılı </Sonuc_Str>

From the ST_TP_Islem_Operation object If the Sonuc 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, 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.

Sample Result Parameters: For transaction NonSecure

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

If the Sonuc > 0, the 'NONSECURE' equality is searched for UCD_URL. If equal, the transaction ends. Islem_ID value is the Decont No value. For a successful NonSecure operation, Sonuc > 0, Islem_ID > 0, and UCD_URL = 'NONSECURE'. Otherwise, the operation is unsuccessful. If the NONSECURE operation is incorrect, the Sonuc_Str value returns the error message from the bank.
If UCD_URL <> 'NONSECURE' is treated as a 3D operation.