Before we delve into the nitty-gritties of integration of your website, we will need to first understand the TrillionPay Architecture.
The TrillionPay Integration process consists of a simple URL exchange format between you as a Member website and TrillionPay Server as the Payment Gateway server. This involves passing certain variables from your server to ours and then passing back the result of the transaction from our server back to yours.
Obviously since variables are being openly passed between your server and TrillionPay we need to ensure that these variables are not tampered along the way. For this purpose a checksum is calculated and passed alongwith the data, using a 32 bit alphanumeric key exchanged between us. This checksum is then recalculated at the other end to verify the authenticity of the data. This is explained in further detail later.
Apart from the above overview you will need to know the meaning of the following variables -
Member ID: Each TrillionPay Member is given a Member ID. As a Member accepting payments online through TrillionPay even you will have a Member ID. This Member ID uniquely identifies you as a Member of TrillionPay. This is very much like a Bank Account number.
Key: Besides the Member ID a 32 bit alphanumeric key is assigned to each Member. This key is used to ensure security of all communications between the Member and TrillionPay. This key can be changed at anytime by the Member by logging into his Merchant Administration interface. It is advised to change this key at regular intervals or immediately upon identifying any security compromise. However, it is important to note that once you change the key your code on the Checkout page will also need to be changed to reflect this.
To describe this in more detail - this key is actually used to calculate a checksum for any message exchanged between the Member's website and TrillionPay. So if the Member is sending some data to transecute a checksum will also be sent alongwith this data. TrillionPay will then take the data and recalculate the checksum at its end and if it does not match the checksum sent by the Member then the data has been tampered on the way and an error will be displayed. Similarly the Member will calculate the checksum for all messages sent to the Member by TrillionPay and verify the accuracy of the data.
Login/Password: A Login and Password is assigned to you upon sign-up, which will allow you to login to your interface. You can login to your Merchant Administration account from http://secure.trillionpay.com/merchant/
The above interface will contain a detailed account of all your transactions. The Merchant Administration interface also has options to modify your settings and other details. Additionally, Members can transfer funds among themselves, but they need to send this request to the Support Team by creating a Support Request.
Test/Live Interface: In order to facilitate easy integration an online testing sandbox environment is offered to all Members. All integration code, modifications and upgrades can be tested here by you before actual deployment.
In Test mode, the Credit Card Payment page is NOT displayed, so there is no chance for charging a Credit Card in Test mode. The purpose of the Test mode is only to test the integration and to verify that the Message Exchange is working properly. In the Test mode, the Member can see three buttons
- to check a Successful Transaction
- to check a High Risk Transaction
- to check a Failed Transaction
If you can see these three buttons, that means, that the Message was successfully exchanged in-between the Member's end and the TrillionPay server [Member -> TrillionPay].
If the Transaction was successful, a Continue button will be displayed and upon clicking this button, you should be re-directed to the Re-direct URL [page]. This indicates that the Message Exchange was successful in-between the TrillionPay server and the Member [TrillionPay -> Member].