Hosted payment Page Integration for Purchase with Tokenization :
SolutionsAe Financial PG Card on File integration allow merchants to tokenized the customer card data in Payment Gateway and allow customers to use already tokenized cards to initiate the payment transactions instead of re-entering the card details during payment. Customer can register their card details through merchant website in payment gateway to re-use it during payments.
Merchant has to store the token , masked card number with register customer unique Id., so when next time customer purchase or do financial transaction from merchant website , he/she will select the already tokenize card and process.
Protocol: https
Method: Post
Content-Type: application/json
Encryption Level: SSL Version 3.0
As an example – The following JSON message can be sent by merchant as one of the permitted service request by means of HTTPS Post method.
Test Environment URL : https://sandbox.solutionsaefinancial.com/merchantservices/transactions/payrequest
There are two legs of transaction in this integration :
- Initiate the request to fetch the payment id and target URL
Sample JSON Request :
{
“terminalId”: “GamingT”,
“password”: “password”,
“action”: “1”,
“trackid”: “6530”,
“amount”: “1.00”,
“address”: “Mahape”,
“customerIp”: “10.10.10.10”,
“merchantIp”: “10.10.10.109”,
“city”: “navi mumbai”,
“zipCode”: “400710”,
“state”:”MH”,
“country”: “IN”,
“contactNumber”:”9892991205″,
“udf1″:”test5”,
“udf2″:”test5”,
“udf3″:”test5”,
“udf4″:”test5”,
“udf5″:”test5”,
“currency”:”BSD”,
“requestHash”:”4dad633c3b86883dd6c5d3bd4d5f1d45ecd10ba7a6cca5ba1976d8348b269b01″,
“customerEmail”:”team@solutionsae.com” ,
“cardHolderNamew”:”demo test”,
“transid”:”2119718201880591248″
}
{“result”:null,”responseCode”:”001“,”authcode”:null,”tranid”:null,”trackid”:null,”terminalid”:null,”udf1″:”test5″,”udf2″:”test5″,”udf3″:”test5″,”udf4″:”test5″,”udf5″:”purchase-voucher”,”rrn”:null,”eci”:null,”subscriptionId”:null,”trandate”:null,”tranType”:null,”integrationModule”:null,”integrationData”:null,”payid”:”2109913939786702684“,”targetUrl”:”https://sandbox.solutionsaefinancial.com/merchantservices/redirect/transactions/load.htm?transid=“,”postData”:null,”intUrl”:null,”responseHash”:null,”amount”:null,”cardBrand”:null,”aRes”:null}
- Merchant should do the form post to target URL with payment id where customer enters the card details and submit the request. The customer who wish to save his card on gateway for subsequent transactions without entering the card details , then he/she has to select the flag available on hosted page i.e Save card. Gateway will process the request further for authorization and once gateway will receive the response from bank will sent it to merchant receipt URL
Merchant has to do form post using below URL :
Redirect URL : https://sandbox.solutionsaefinancial.com/merchantservices/redirect/transactions/load.htm?transid=
Final Response : https://sandbox.solutionsaefinancial.com/CORE_2.2.2/resultPage.jsp?PaymentId=2109913939786702684&TranId=2109913939786702684&AuthCode=025143&ECI=null&Result=Successful&TrackId=101010&ResponseCode=000&UserField1=test5&UserField2=test5&UserField3=test5&UserField4=test5&UserField5=purchase-voucher&RRN=09KXJMUEM4MVQF5DUAB&amount=1.00&responseHash=fd8e9acdae86ee475599294e511119536e021583404aa65b9331fa3a2a914ca6&CardBrand=VISA&voucher_code=3001825017430&batch_number=503941B20217ZH59JKCYXW&pin=55583&CardToken=0704045678864266603&MaskedCard=4111xxxxxxxx1111
- The merchant has to store the card token , masked card received from the PG on their website/database link with customer unique id, so when next time customer comes to merchant website for ecom transactions on payment check out page he/she can see the masked card details.
- So for second time onward Customer only click on pay button with already stored card details on merchant website, here merchant will send the card token request to payment gateway as below ;
Sample JSON Request :
{
“terminalId”: “GamingT”,
“password”: “password”,
“action”: “1”,
“trackid”: “6530”,
“amount”: “1.00”,
“address”: “Mahape”,
“customerIp”: “10.10.10.10”,
“merchantIp”: “10.10.10.109”,
“city”: “navi mumbai”,
“zipCode”: “400710”,
“state”:”MH”,
“country”: “IN”,
“contactNumber”:”9892991205″,
“udf1″:”test5”,
“udf2″:”test5”,
“udf3″:”test5”,
“udf4″:”test5”,
“udf5″:”test5”,
“currency”:”BSD”,
“requestHash”:”4dad633c3b86883dd6c5d3bd4d5f1d45ecd10ba7a6cca5ba1976d8348b269b01″,
“customerEmail”:”team@solutionsae.com” ,
“cardHolderNamew”:”demo test”,
“transid”:”2119718201880591248″,
“cardToken”:”0704045678864266603″,
}
{“result”:null,”responseCode”:”001“,”authcode”:null,”tranid”:null,”trackid”:null,”terminalid”:null,”udf1″:”test5″,”udf2″:”test5″,”udf3″:”test5″,”udf4″:”test5″,”udf5″:”purchase-voucher”,”rrn”:null,”eci”:null,”subscriptionId”:null,”trandate”:null,”tranType”:null,”integrationModule”:null,”integrationData”:null,”payid”:”2109913939786702684“,”targetUrl”:”https://sandbox.solutionsaefinancial.com/merchantservices/redirect/transactions/load.htm?transid=“,”postData”:null,”intUrl”:null,”responseHash”:null,”amount”:null,”cardBrand”:null,”aRes”:null}
- Merchant should do the form post to target URL with payment id where gateway will redirect the customer on capture CVV page where customer will enter the CVV of card . Gateway will process the request further for authorization and once gateway will receive the response from bank will sent it to merchant receipt URL
Merchant has to do form post using below URL :
Redirect URL : https://sandbox.solutionsaefinancial.com/merchantservices/redirect/transactions/load.htm?transid=
Final Response : https://sandbox.solutionsaefinancial.com/CORE_2.2.2/resultPage.jsp?PaymentId=2109913939786702684&TranId=2109913939786702684&AuthCode=025143&ECI=null&Result=Successful&TrackId=101010&ResponseCode=000&UserField1=test5&UserField2=test5&UserField3=test5&UserField4=test5&UserField5=purchase-voucher&RRN=09KXJMUEM4MVQF5DUAB&amount=1.00&responseHash=fd8e9acdae86ee475599294e511119536e021583404aa65b9331fa3a2a914ca6&CardBrand=VISA&voucher_code=3001825017430&batch_number=503941B20217ZH59JKCYXW&pin=55583&CardToken=0704045678864266603&MaskedCard=4111xxxxxxxx1111