Web page developers can integrate the ePayments Secure Transaction Processing Server directly into a merchants Web page by simply following the instructions below.

• Requirements
  • Form Declaration
  • Account Number
  • Order Identification
  • Customer Identification
  • Display Price
  • Total Charges
  • Item Identifiers
  • Post Processing Return URL
  • Logo URL
  • Billing Info
  • Shipping Info
  • Custom Variables

FORM DECLARATION

The form declaration used in your order page should be:
<FORM METHOD=POST ACTION="https://search4india.com/payment/default.asp">

ACCOUNT NUMBER
The merchants ePaymentsglobal account number must be passed in as follows:
<INPUT TYPE=HIDDEN NAME="AccountNo" VALUE="10129">
DO NOT pass in the merchants' bank merchant account number. The account number you pass in MUST be the merchants' ePaymentsglobal account number.

ORDER NUMBER

The merchants OrderNumber must be passed as follows: <INPUT TYPE=HIDDEN NAME=ORDERNO VALUE="5">

Pass the order number generated when the buyer checks out from the cart.

CUSTOMER IDENTIFICATION
<INPUT TYPE="HIDDEN" NAME="customerid" VALUE="4">
<input TYPE="hidden" NAME="customername" VALUE="john">
Pass the customer identification values as shown above. This is for the future reference of your transaction with customer.

DISPLAY PRICE
Formatted purchase amount. This field may contain a currency symbol, with an thousands separator (s), decimal point and ISO minor units defined for the currency Ex. INR1,234.56

TOTAL CHARGES
<input TYPE="hidden" NAME="totalamount" VALUE="100">
<input TYPE="hidden" NAME="totalshippingcharges" VALUE="5">
Total sale and shipping charges of order processed.

ITEM IDENTIFIERS
Six identifiers for each item available from the merchants order page (Item_Id, Item_Name, description, quantity, price and shipping charges) must be passed to the script.
The Item_Id for each item can be hard-coded or input by the user, but the name of the Item_Id variable (e.g. Item_Id) must be in the format Item_Id_i for each item where i is an Item indexer starting from 1. One suggested way of passing the Item_Id of each item is as follows: <INPUT SIZE=5 NAME="Item_Id_1" MAXLENGTH=3 VALUE="1000">
<INPUT SIZE=5 NAME="Item_Id_2" MAXLENGTH=3 VALUE="1001">

 

The Item_Name field for each item can be hard-coded or inputed by the user, but the name of the Item_Name variable (e.g. Item_Name) must be in the format Item_Name_i for each item where i is an Item indexer starting from 1. One suggested way of passing the Item_Name of each item is as follows:
<INPUT SIZE=5 NAME="Item_Name_1" MAXLENGTH=3 VALUE="Item 1">
<INPUT SIZE=5 NAME="Item_Name_2" MAXLENGTH=3 VALUE="Item 2">

 

 

The Item_Qty field for each item can be hard-coded or inputed by the user, but the name of the quantity variable (e.g. Item_Qty) must be in the format Item_Qty_i for each item where i is an Item indexer starting from 1. The quantity will be multiplied by price of each item to display a summary of the order and calculate an order total. One suggested way of passing the quantity of each item is as follows: <INPUT SIZE=5 NAME="Item_Qty_1" MAXLENGTH=3 VALUE="1">
<INPUT SIZE=5 NAME="Item_Qty_2" MAXLENGTH=3 VALUE="2">

 

The description of each item must be passed to the script using the name Item_Desc which should be in the format Item_Desc_i for each item where i is an Item indexer starting from. 1.These can be sent as HIDDEN values as follows: <INPUT TYPE=HIDDEN NAME="Item_Desc_1" VALUE="Large Widget">
or you may need to allow the user to enter a description:
<INPUT SIZE=30 NAME="Item_Desc_1" VALUE="">

 

 

The price of each item must be passed using the name Item_Price in the format Item_Price_i for each item where i is an Item indexer starting from 1. One suggested way to do this would be: <INPUT TYPE=HIDDEN NAME="Item_Price_1" VALUE="34.95">

 

The Shipping Charges of each item must be passed using the name Item_ShippingCharge in the format Item_ShippingCharge_i for each item where i is an Item indexer starting from 1. One suggested way to do this would be: <INPUT TYPE=HIDDEN NAME="Item_ShippingCharge_1" VALUE="20">
Always group your variables together in sequence, i.e.
<INPUT TYPE=HIDDEN SIZE=5 NAME="Item_Id_1" MAXLENGTH=3 VALUE="1000">
<INPUT TYPE=HIDDEN SIZE=5 NAME="Item_Name_1" MAXLENGTH=3 VALUE="Item 1">
<INPUT TYPE=HIDDEN SIZE=5 NAME="Item_Qty_1" MAXLENGTH=3 VALUE="1">
<INPUT TYPE=HIDDEN NAME="Item_Desc_1" VALUE="Large Widget" >
<INPUT TYPE=HIDDEN NAME="Item_Price_1" VALUE="34.95">
<INPUT TYPE=HIDDEN NAME="Item_ShippingCharge_1" VALUE="500">
<INPUT SIZE=5 NAME="Item_Id_2" MAXLENGTH=3 VALUE="1000">
<INPUT SIZE=5 NAME="Item_Name_2" MAXLENGTH=3 VALUE="Item 1">
<INPUT TYPE=HIDDEN SIZE=5 NAME="Item_Qty_2" MAXLENGTH=3 VALUE="1">
<INPUT TYPE=HIDDEN NAME="Item_Desc_2" VALUE="Large Widget" >
<INPUT TYPE=HIDDEN NAME="Item_Price_2" VALUE="34.95">
<INPUT TYPE=HIDDEN NAME="Item_ShippingCharge_1" VALUE="0">

POST PROCESSING URL
POST PROCESSING URL The customer is returned to the specified page url after the transaction is completed. In case of successful payment the customer will be returned to the ReturnApprovedUrl And in case of unsuccessful payment the customer is returned back to the ReturnDeclinedUrl. For the successful/unsuccessful transaction, the return page url can be specified as follows:
<input type=hidden name="ReturnApprovedURL"
value="http://www.merchants_page.com/gohere">
<input type=hidden name="ReturnDeclinedURL"
value="http://www.merchants_page.com/gohere">
When any of the payment transaction is done you will get instant payment notification on specified NotifyUrl page.
As any transaction takes place all the transaction variables that were passed to the payment gateway are posted to the notifyUrl page. In addition to it you will receive two new vairiables "TxnId" and "Status" on notifyUrl page. TxnId is a unique transaction id generated by the payment gateway which can be used for future reference. Status indicates the order status and it can have any of the following values.

Status	Description
SUCCESS	If the transaction is successful and customer has made payment.
FAILURE	If the transaction is unsuccessful and customer has not made payment.
EXECUTED	If any of the transaction order sub-item is cancelled, refunded or delivered.
IN_PROCESS	If any of the transaction order sub-item is marked for pending delivery state.

On notifyUrl page you will receive following transaction order item status
If the status field has "EXECUTED" or "IN_PROCESS" value, transaction order sub-items will have following status and additional field values.

Status	Additional Fields	Description
PENDING_EXECUTION	-	If the transaction is successful and customer has made payment.
FAILURE	-	If the transaction is unsuccessful and customer has not made payment.
PENDING_DELIVERY	item_next_capture_date_1 item_remarks_1	-
DELIVERED	item_delivery_date_1 item_pod_no_1 item_courier_name_1 item_delivery_date_2 item_pod_no_2 item_courier_name_2	When the transaction has "EXECUTED" or "IN_PROCESS" status value and item is marked for pending delivery state. item_next_capture_date_i where i is the item number specifies the next capture date for the transaction item. And item_remarks_i field indicates any remark entered while setting the transaction item status to "PENDING_DELIVERY". When the transaction has "EXECUTED" or "IN_PROCESS" status value and item is delivered. item_delivery_date_i specifies the item delivery date. item_pod_no_i specifies POD No. for the delivered item. item_courier_name_i specifies courier name for the delivered item.
CANCELLED	-	When the transaction has "EXECUTED" or "IN_PROCESS" status value and transaction is partially captured and the item is rejected or cancelled.
CANCELLED_SYSTEM	-	When the transaction has "EXECUTED" status value and complete transaction is automatically cancelled by the system because it is not captured / executed within 12 days.
REFUNDED	-	When the transaction has "EXECUTED" or "IN_PROCESS" status value and item amount is refunded. In this case there will be one more order variable namely "refundamount" which indicates the total refunded amount for the complete transaction / order.

You can specify on which page you want to receive instant payment notification using the notifyUrl variable.
<input type=hidden name="NotifyUrl" value="http://www.merchants_page.com/gohere">
Be sure to change http://www.merchants_page.com/gohere to the correct page url on your website.

LOGO URL - (optional, null value can be passed)
The logo to display on all transaction-related pages output by us can be specified as follows:
<INPUT TYPE=HIDDEN NAME="LogoURL"
VALUE="http://www.MerchantsWebSite.Com/MerchantsLogo.gif">
A complete URL is required, including "http://www.". This allows merchants to utilize different logos from different pages if so desired.

BILLING INFO
You can pass Billing Info to the ePaymentsglobal Server in the format for these field names is as follows:

BillFirstName
BillLastName
BillAddress1
BillAddress2 (optional, null value can be passed)
BillAddress3 (optional, null value can be passed)
BillCity
BillState
BillZipCode
BillCountry (3 character ISO country code i.e. IND for India, USA for United States)
BillPhoneNo (optional, null value can be passed)
BillMobileNo (optional, null value can be passed)

BillEMail

This information can be passed in as a hidden type, i.e.

<INPUT TYPE=HIDDEN NAME="BillFirstName" VALUE="John">

 

or by prompting the user with:

<INPUT TYPE=TEXT NAME="BillFirstName" VALUE="">

SHIPPING INFO

You can pass Billing Info to the ePaymentsglobal Server in the format for these field names is as follows: ShipFirstName
ShipLastName
ShipAddress1
ShipAddress2 (optional, null value can be passed)
ShipAddress3 (optional, null value can be passed)
ShipCity
ShipState
ShipZipCode
ShipCountry (3 character ISO country code i.e. IND for India, USA for United States)
ShipPhoneNo (optional, null value can be passed)
ShipMobileNo (optional, null value can be passed)
ShipEMail

 

This information can be passed in as a hidden type, i.e.
<INPUT TYPE="HIDDEN NAME"="ShipFirstName" VALUE="John">

 

or by prompting the user with:
<INPUT TYPE="TEXT" NAME="ShipFirstName" VALUE="">

CUSTOM VARIABLES
You can pass any number of custom variables that you will receive back at notifyurl page.
you can pass custom variables as follows:
<INPUT TYPE=HIDDEN NAME="custom_1" VALUE="value1">
<INPUT TYPE=HIDDEN NAME="custom_2" VALUE="value2">
<INPUT TYPE=HIDDEN NAME="custom_3" VALUE="value3">