Payment Methods

Method Name: TP_WMD_UCD

Nonsecure/3D payment is the method to initiate the transaction. For 3D transactions, the method prints the returned 3D Bank HTML content to the screen and performs redirection. Credit card verification process begins.

Control Scenarios
You can find the test scenarios we expect to be performed during the integration process here.

Order Amount Calculation Including Commission
Commission Rate: TP_Ozel_Oran_SK_Liste commission rate of the installment selected from the method
Islem_Tutar: Amount of your order
Total_Amount = Islem_Tutar + ((Islem_Tutar x Commission Rate) / 100)
.

If the result parameter is greater than "0", print the content of UCD_HTML to the screen to initiate the 3D Secure Payment process. To complete the credit card transaction, you need to follow the steps below.

For NonSecure transactions (Important)
If Sonuc > 0, check if UCD_HTML equals 'NONSECURE'. If it does, the transaction ends. The Islem_ID value is the Receipt No value.
For a successful NonSecure transaction, Sonuc > 0, Islem_ID > 0, and UCD_HTML must be 'NONSECURE'. Otherwise, the transaction is unsuccessful.
In case of an error in the NONSECURE transaction, the Sonuc_Str value returns the error message from the bank.
If Sonuc > 0 and UCD_HTML is not 'NONSECURE', treat it as a 3D transaction.

If the company MCC (Merchant Category Code) is one of the following values: “5960 DIRECT MARKETING – INSURANCE”, “6300 INSURANCE SALES AGENTS”, or “6363 PENSION AND LIFE INSURANCE”, the NS transaction can be processed in a masked manner.
The information should be transmitted as follows:
KK_No: first 6 digits ****** last 4 digits
KK_SK_Ay: **
KK_SK_Yil: ****
Data1: TCKN/VKN/YKN

TP_WMD_UCD Hash Formula

                        
                Dim Transaction_Security_Str$ = CLIENT_CODE & GUID & Taksit & Islem_Tutar & Toplam_Tutar & Siparis_ID 
                Dim Transaction_Hash$ = SHA2B64(Transaction_Security_Str)
            
        

Hash Control
To perform parameter verification, the following procedure must be followed.

Parameters that make up the hash value
islemGUID + md + md + mdStatus + orderId + GUID(key Lower as small must go)

Hash value encoded as based64 (SHA1)

Example code
Dim _sha As SHA1 = New SHA1CryptoServiceProvider()
Dim _bytes() As Byte = System.Text.Encoding.UTF8.GetBytes(islemGUID + md + mdStatus + orderId + GUID (Member's workplace key) )
Dim _hashingbytes() As Byte = _sha.ComputeHash(_bytes)
Dim _hash As String = Convert.ToBase64String(_hashingbytes)

The hash value you created and the posted islemHash value must be the same.

mdStatus Values

1 = Verified Process (Full 3D)
2, 3, 4 = card not registered (Half 3D)
5, 6, 7, 8 = No valid validation or system error
0 = Verification Failed

mdStatus : If 1, 2, 3, 4, you can send a request to the TP_WMD_Pay method to complete the payment.
mdStatus : If 0,5,6,7,8, 3D verification failed. Do not send a request to the TP_WMD_Pay method.

Completing the Sales Transaction (3D Transactions for)

Method Name: TP_WMD_Pay

This method is used to debit the amount from the verified cards.

If Sonuc > 0 and Dekont_ID > 0, the transaction is successful. Otherwise the transaction is a failure.

THIS METHOD IS NOT USED IN NEW INTEGRATIONS!

Method Name: Pos_Odeme

This method is the method to start the Nonsecure / 3D payment process. (VirtualPOS_ID parameter is removed.) The 3D URL returned as a result of the transaction is redirected and the credit card payment process starts.

Control Scenarios
During integration, you can access the test scenarios we expect to be performed here.

Order Amount Calculation Including Commission
Commission Rate: rate of the installment selected from TP_Ozel_Oran_SK_Liste method
Islem_Tutar: The amount of your order
Total_Amount = Islem_Tutar + ((Islem_Tutar x Commission Rate) / 100)
is calculated as shown above.

If the Result parameter obtained from the ST_TP_Islem_Odeme object is greater than "0", redirect to the UCD_URL parameter to initiate the 3D Secure Payment process. Whether the credit card payment is successful or unsuccessful, POST is provided to the Hata_URL or Basarili_URL values.

If the Company MCC (Merchant Category Code) is one of the values "5960 DIRECT SALES-INSURANCE", "6300 INSURANCE AGENTS", "6363 PENSION AND LIFE", it can process the transaction in a masked manner for NS operations.
It should provide the following information:
- KK_No: first 6 digits ****** last 4 digits
- KK_SK_Ay: **
- KK_SK_Yil: ****
- Data1: ID Number

Pos Payment Hash Formula

                 
                    Dim Transaction_Security_Str$ = CLIENT_CODE & GUID & Taksit & Islem_Tutar & Toplam_Tutar & Siparis_ID & Hata_URL & Basarili_URL 
                    Dim Transaction_Hash$ = SHA2B64(Transaction_Security_Str)