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="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>
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
<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 > 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.