Pre-Authorization

Method Name: TP_Islem_Odeme_OnProv_WMD

This is the method that initiates a Nonsecure/3D payment transaction. For 3D transactions, the HTML code content returned by the method is displayed on the screen, and the redirection is performed. The credit card verification process begins.

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

Order Amount Calculation Including Commission
Commission Rate: The installment's commission rate selected from the 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.

If the Sonuc parameter is greater than "0", print the UCD_HTML content on the screen to initiate the 3D Secure Payment process. Follow the steps below to complete the payment transaction from the credit card.

For NonSecure Transactions (Important)
If Sonuc > 0, UCD_HTML is checked for equality to 'NONSECURE'. If they match, the transaction ends. Islem_ID value represents the Receipt Number.
For a successful NonSecure transaction, Sonuc > 0, Islem_ID > 0, and UCD_HTML='NONSECURE' must all be true. Otherwise, the transaction fails.
If the NONSECURE transaction fails, Sonuc_Str returns the error message from the bank.
If Sonuc > 0 and UCD_HTML <> 'NONSECURE', it is handled like a 3D transaction.

TP_Islem_Odeme_OnProv_WMD Hash Formula

                        
                Dim Transaction_Security_Str$ = CLIENT_CODE & GUID & Islem_Tutar & Toplam_Tutar & Siparis_ID & Hata_URL & Basarili_URL 
                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 + mdStatus + orderId + GUID (key should go as Lower)

The hash value is 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 (Key of the Merchant))
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 Transaction (Full 3D)
2, 3, 4 = Card not enrolled (Half 3D)
5, 6, 7, 8 = No valid authentication or system error
0 = Verification Failed

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

Completing the Pre-Authorization Process (for 3D Transactions)

Method Name: TP_WMD_Pay

This method is used to complete the pre-authorization from the verified cards.

Parameters to send:

Result Parameters:

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

You can switch to the Pre-authorization - Closing method.

You can find the test scenarios we expect during the integration here.

Method Name: TP_Islem_Odeme_OnProv_Kapa

Converts the pre-authorization transaction into a sale.

Method Name: TP_Islem_Iptal_OnProv

This method is used to cancel a provision for which no sales transaction has been made.