Web page developers can integrate the ePayments Secure Transaction
Processing Server directly into a merchants Web page by simply
following the instructions below.
FORM DECLARATION
The form declaration used in your order page should be:
<FORM METHOD=POST ACTION="https://search4india.com/payment/default.asp">
Top
ACCOUNT NUMBER
The merchants ePayments 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' ePayments account
number.
Top
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.
Top
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.
Top
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
Top
TOTAL CHARGES
<input TYPE="hidden" NAME="totalamount" VALUE="100">
<input TYPE="hidden" NAME="totalshippingcharges" VALUE="5">
Total sale and shipping charges of order processed.
Top
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"> Top
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.
Top
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.
Top
BILLING INFO
You can pass Billing Info to the ePayments 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="">
Top
SHIPPING INFO
You can pass Billing Info to
the ePayments 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="">
Top
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"> Top |
