Visa 3D Secure
Visa 3D Secure
Implementation of 3D secure requires the following changes to how the merchant sends and processes the data.
Include the following fields:
Variable | Required | Max Size | Value | Notes |
termurl | Mandatory | NA | URL of merchant’s processing scrtip. | |
tdsflag | Mandatory | NA | 1 | When set to ‘1’ indicates that the transaction should be processed as 3D secure. |
1. Merchant must subscribe to the 3D secure program. Additional fees apply, so please contact either your sales agent or technical support.
2. When a 3D secure registered credit card is presented for payment, the system will respond with all submitted variables as well as name value pairs delineated below.
Variable | Value | Notes |
FinalStatus | success/problem | success - Transaction was processed successful.problem - Transaction failed. |
tdsauthreq | Authentication Request Page | If returned, the contents of this variable must be returned to the customer un-altered. |
3. If the variable ’tdsauthreq’ is returned along with a value for FinalStatus of ‘success’, then the value for this variable must be returned to the customer unaltered.
This will redirect the customers to the Authentication Web Site (Visa/Mastercard) The browser will contain a request to enter their 3D secure password.
4. Once the customer enters their password and authenticates, the merchant will receive another form POST to the processing script as specified in the variable ’termurl’.
The post-authentication payment request can be identified by the presence of one of the following variables depending on your 3D Secure processor:
Variable | Value | Notes |
MD | wirecard3ds | This will only be returned for merchants using Wirecard. |
OrderID | firstatl,{your account name},{Transaction orderID} | This will only be returned for merchants using First Atlantic. |
5. All name/value pairs received during the post-authentication request must be sent to the payment URL identified at the beginning of this section, typically pnpremote.cgi.
6. The gateway will respond to this secondary request as outlined in the paragraph Response Fields - the same as if the transaction was not a 3D secure transaction.