Intended Audience – Transparent Redirect
This document is technical in nature and should be used by your company’s developers to integrate your systems into the…
Simplifying the Integration Process – Transparent Redirection
There are many complexities when dealing with card transactions. If you try and tackle them all at once the task…
Gateway URLs
In this document, payment gateway specific URLs have “thepaymentgateway.net” as the domain (For example, https://mms. thepaymentgateway.net/). When using these URL’s…
Hashing Explained
When the Hosted Payment Form solution is implemented, the transaction data must be protected as it is being passed to…
Simple Hashing Example
Here is an example of some transaction variables: MerchantID: YourCo-1234567 Amount: 100.00 CurrencyCode: 826 OrderID: 12345 These variables would be…
Data Types
Data Type Description N Numeric – only numbers allowed A Alpha – any printable character is allowed B Boolean –…
Input Variables
Below is a description of the variables that comprise the input API of the payment form. This request may yield…
Incoming Hash Digest
Below is the order that the variables should be listed when creating the hash digest. The string to be hashed…
Output Variables
Below is a description of the variables that will be posted to the merchant’s CallbackURL when the cardholder needs to…
Outgoing Hash Digest
Below is the order that the variables will be listed when creating the 3D Secure “authentication required” payment response hash…
Input Variables
Below is a description of the variables that comprise the input API of the 3D Secure Authentication portion of the…
Incoming Hash Digest | Hash Codes
Below is the order that the variables should be listed when creating the 3D Secure authentication request hash digest to…
Output Variables
Below is a description of the variables will be posted to the merchant’s CallbackURL. These comprise the “Payment Complete” output…
Outgoing Hash Digest
Variable Name Mandatory or Always Present Comments PreSharedKey See comments The pre shared key should ONLY be included in the…
Appendix 1: Gateway Response Status Codes | Payb
Below are the status codes likely to be received when integrating with the gateway. Status Code Transaction Result Description …
Appendix 2: Transaction Data Flow
Listed below are the steps that a Transparent Redirect transaction will take. There are also 3 diagrams to show the…
ACS Simulator – Integration Guide
The test system comes complete with an ACS simulator, which allows your developer to simulate the most common responses that…
Initial Request
This is a sample SALE transaction HTML form which is submitted to the gateway Hosted Payment Form URL. <form action="https://mms.paymentprocessor.net/Pages/PublicPages/TransparentRedirect.aspx"…
3D Secure Authentication Required – Response
This is an example response for a transaction requiring 3D Secure Authentication. This response would have been sent via POST…
3D Secure Post Authentication – Response
This is an example 3D Secure Post Authentication response. This response would have been sent via POST to the merchant’s…
3D Secure Post Authentication – Request
This is an example response for a transaction requiring 3D Secure Authentication. This response would have been sent via POST…
Transaction Complete – Response
This is an example response for a completed transaction. This response would have been sent via POST to the merchant’s…
Appendix 4: Transaction Result Status Codes
The StatusCode is a numerical value representation for the result of the transaction. If any other code is returned not…
OverrideAVSPolicy Codes
The OverrideAVSPolicy codes are 4 character codes which instruct the gateway how to handle the AVS checking for that particular…
Character 1 Codes
Character Code Explanation E This code means fail the transaction if either the address numeric check or post code check…
Character 2 Codes
Character Code Explanation P Treat partial address numeric results as passes F Treat partial address numeric results as failures
Character 3 Codes Payb
Character Code Explanation P Treat partial post code results as passes F Treat partial post code results as failures
Character 4 Codes
Character Code Explanation P This code means pass the transaction if both results of the AVS check are not known…
Examples
EFFF – this is the strongest policy & transactions will only pass if both address numeric & post code checks…
Questions
Q: Why would the results of the AVS check be unknown? A: The main reasons for the results of the…
OverrideCV2Policy Codes
The OverrideCV2Policy codes are 2 character codes which instruct the gateway how to handle the CVV code (CV2) checking for…
Character 1 Codes
Character Code Explanation P This code means pass the transaction if the CV2 check has failed F This code means…
Character 2 Codes
Character Code Explanation P This code means pass the transaction if both results of the CV2 check are not known…
Examples
FF – this is the strongest policy & transactions will only pass if the CV2 check has passed FP –…
Questions
Q: Why would the CV2 result be unknown? A: The main reasons for the result being unknown are: The CV2…
Appendix 6: Country (ISO 3166-1) Codes
ISO Code Country 826 United Kingdom 840 United States 036 Australia 004 Afghanistan 248 Åland Islands 008 Albania 012 Algeria…
Appendix 7: Currency (ISO 4217) Codes
ISO Code Currency 826 Pound Sterling 840 US Dollar 978 Euro 971 Afghani 12 Algerian Dinar 32 Argentine Peso 51…