Nonsecure/3D Payment

Method Name: TP_Islem_Odeme_WNS

Nonsecure/3D is the method by which the payment process will be initiated.

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 Type Length Description
G NS - T_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_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 Siparis_ID. As a result of this The Siparis_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_Guvenlik_Tip N 2 NS (NonSecure) or 3D are sent.
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 256 Extra Space 1
Data2 N 256 Extra Space 2
Data3 N 256 Extra Space 3
Data4 N 256 Extra Space 4
Data5 N 256 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
Banka_Sonuc_Kod I - 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.