Hi
I want to make a Credit Card Payment Plugin for nopcommerce v3.80 , MVC is new for me thats why i face difficulty.
Below is the Plugin Integration detail , Please guide me how to make this plugin.
If some one make this plugin for me , i shall be very thankful for this act of kindness.
2.2. Plug-in Integration Steps:
Following process will be followed by merchants to embed the ‘Easypay’ Plug-in in their stores:
Merchant acquires an account through Easypay agents. A Welcome email containing unique Store ID and URL is sent to the Merchant after successful registration.
Merchant logins the Easy Pay portal and access ‘Guide to Integration’ menu where Merchant is presented with step by step instructions to integrate the Easypay plug- in to their shopping cart/online retail shop.
Following is the sample of flow merchant should find after logging into the Easypay portal.
Merchants having unique store ID embed Easypay plug-in on checkout page of their online stores/ websites. This will integrate “Pay through Easypay” as a payment solution in their websites. The integration of Easypay plug-in is a simple two-step process:
1. The merchant needs to POST following parameter to the Easypay on the following URL:
Production (Live) Environment:
https://easypay.easypaisa.com.pk/easypay/Index.jsf
Sandbox Environment:
https://easypaystg.easypaisa.com.pk/easypay/Index.jsf
amount
storeId
postBackURL
orderRefNum
expiryDate (Optional)
merchantHashedReq (Optional)
autoRedirect (Optional)
paymentMethod (Optional)
emailAddr (Optional)
mobileNum (Optional)
Parameter O/M Name Explanation Possible Values
Amount
M
amount
Total amount of the transaction in PKR
Numeric
Store Id
M
storeId
Id of the store as provided by the Telenor POC
Numeric
Post back URL
M
postBackURL
The first post back URL for confirmation
Character
Order Reference Number
M
orderRefNum
Merchant Generated order reference number
Character
Expiry Date
O
expiryDate
Merchant provided expiry date for the particular transaction
YYYYMMDD HHMMSS
Merchant Hashed
O
merchantHashedReq
Hash value for the request
Character
Page 9 of 29
Parameter O/M Name Explanation Possible Values
Request
Auto Redirect
O
autoRedirect
If merchant wants to redirect to final post back URL and the end of transaction
0/1
Payment Method
O
paymentMethod
If merchant wants the customer to land on specific payment page
OTC_PAYMENT_METHOD/
MA_PAYMENT_METHOD/
CC_PAYMENT_METHOD
Email Address
O
emailAddr
If the merchant wants to pass the customer’s entered email address it would be pre populated on Easypay checkout screen.
[email protected]
Mobile Number
O
mobileNum
If the merchant wants to pass the customer’s entered mobile number it would be pre populated on Easypay checkout screen.
03325241789
After successful redirection the customer would land on the Easypay Checkout Screen where there is a form to be filled regarding the transaction information.
2. After completing the form in Step 1 the customer will be pressing the Proceed Button and lands back on the merchant website on the same URL given in postbackURL variable in the first step. This will be a confirmation screen on merchant’s website to perform a handshake between Easypay and merchant’s website. The Easypay sends back a parameter named auth_token to the postbackURL which is sent as a GET parameter. Now the merchant needs to post back following two parameters again to the following URL:
Production (Live) Environment:
https://easypay.easypaisa.com.pk/easypay/Confirm.jsf
Sandbox Environment:
https://easypaystg.easypaisa.com.pk/easypay/Confirm.jsf
auth_token
postBackURL
After this redirection the Easypay authenticates the auth_token sent by merchant with the one it has in the previous step, and upon successful authentication it will make customer land on the successful checkout screen sending back following two variables to the second postBackURL:
status
desc
orderRefNumber
Page 10 of 29
2.3. Plug-in Integration Code Samples:
Following Code Snippet can be used as a reference for the redirection performed in Step 1:
<form action=" https://easypay.easypaisa.com.pk/easypay/Index.jsf " method="POST" target="_blank">
<! -- Store Id Provided by Easypay-->
<input name="storeId" value="43" hidden = "true"/>
<! -- Amount of Transaction from merchant’s website -->
<input name="amount" value="10" hidden = "true"/>
<! – Post back URL from merchant’s website -- >
<input name="postBackURL" value=" http://www.my.online-store.com/transaction/MessageHandler" hidden = "true"/>
<! – Order Reference Number from merchant’s website -- >
<input name="orderRefNum" value="1101" hidden = "true"/>
<! – Expiry Date from merchant’s website (Optional) -- >
<input type =”hidden” name=”expiryDate” value=”20140606 201521”>
<! – Merchant Hash Value (Optional) -- >
<input type =”hidden” name=”merchantHashedReq” value=”askldjflaksdjflkasdf======asdfas dfkjaskdf”>
<! – If Merchant wants to redirect to Merchant website after payment completion (Optional) -- >
<input type =”hidden” name=”autoRedirect” value=”0”>
<! – If merchant wants to post specific Payment Method (Optional) -- >
<input type =”hidden” name=”paymentMethod” value=”0”>
<! – If merchant wants to post specific Payment Method (Optional) -- >
<input type =”hidden” name=”emailAddr” value=”[email protected]”>
<! – If merchant wants to post specific Payment Method (Optional) -- >
<input type =”hidden” name=”mobileNum” value=”03325241789”>
<! – This is the button of the form which submits the form -- >
<input type = “image” src=”checkout-button-with-logo.png border=”0” name= “pay”>
</form>
Output:
After successful implementation, the below button would appear on the website of the merchant.
Following Code Snippet can be used as a reference for the redirection performed in Step 2:
<form action=" https://easypay.easypaisa.com.pk/easypay/Confirm.jsf " method="POST" target="_blank">
<input name="auth_token" value="<?php echo $_GET['auth_token'] ?>" hidden = "true"/>
<input name="postBackURL" value=" http://www.my.online-store.com/transaction/MessageHandler1" hidden =
"true"/>
<input value="confirm" type = "submit" name= "pay"/>
</form>
Following Code Snippet can be used as a reference to retrieve the transaction status sent on the fly by Easypay:
<input name="auth_token" value="<?php echo $_GET['status'] ?>"/>
<input name="postBackURL" value="<?php echo $_GET['desc'] ?>"/>
<input name="orderRefNumber" value="<?php echo $_GET['orderRefNumber'] ?>"/>
Following are the possible values for the parameters:
Parameter O/M Name Explanation Possible Values
Status
M
status
Status of the transaction
“Success”, “Failure”
Description
M
desc
Code ID for the status
“0000”, “0001”
Order Reference Number
M
orderRefNum
Merchant Generated order reference number
Character