|
EZ Payment
Gateway
FAQ's
Why am I
getting an Invalid operation_type
message?
You are not
passing 'auth' as the
operation_type or you may be
trying to use the GET method
instead of the POST
method.
What does
the POST Data that you send to
GoEmerchant.com look
like?
merchant=mystorename&password=123test&operation_type=auth&orderid=123456
&total=1.00&cardname=Visa&cardnum1=4111&cardnum2=1111&cardnum3=1111
&cardnum4=1111&cardexpm=01&cardexpy=02&nameoncard=John
Doe
&cardstreet=123 Any
Street&cardcity=Any
City&cardstate=NJ
&cardzip=08000&cardcountry=US |
What will
GoEmerchant.com return back to me
for both the process.aspx and
direct.aspx?
GoEmerchant's script
will use the GET method to return
the following information to the
URL that it was
given:
| Key |
Value |
| OrderID |
echoed
back from the server that
was provided in the secure
post |
| total |
total
amount authed |
| Status |
will
return 1 if success, 0 if
failed |
| approval_code |
approval
code returned by
bank |
| authresponse |
authorization response
returned by
bank |
| Cardname |
type of
credit card |
| NameonCard |
name of
cardholder |
| Cardstreet |
street
of cardholder |
| Cardcity |
city of
cardholder |
| Cardstate |
state of
cardholder (two letter
state
abbreviations) |
| Cardzip |
zip code
of cardholder |
| Cardcountry |
country
of cardholder (two letter
country
abbreviations) |
| email |
email
address of customer
(optional) |
*** To see
examples of query strings, html
forms, and perl scripts you can
visit our online guide.
If you are linking to the 'EZ
Payment Gateway secure payment
form'
(process.aspx),
click
here.
If you are linking directly to
the 'EZ Payment Gateway'
(direct.aspx),
click
here.
XML
Gateway
FAQ's
What to I need
to send to the XML
Gateway?
<?xml
version="1.0"
encoding="UTF-8"?>
<TRANSACTION>
<FIELDS>
<FIELD
KEY="merchant">merchant
id</FIELD>
#
assigned by
gateway
<FIELD
KEY="password">pwd</FIELD>
#
assigned by
gateway
<FIELD
KEY="operation_type">auth/sale</FIELD>
<FIELD
KEY="order_id">MUST
BE UNIQUE
ASSIGNED</FIELD>
<FIELD
KEY="total">(In US
Dollars. Example 59.99 No $
signs.)</FIELD>
<FIELD
KEY="card_name">(Visa,
Amex, Discover or
MasterCard)</FIELD>
<FIELD
KEY="card_number">15|16
digit credit card
number</FIELD>
<FIELD
KEY="card_exp">MMYY</FIELD>
<FIELD
KEY="cvv2">3 digit cvv2
code</FIELD>
# not
required
<FIELD
KEY="owner_name">name</FIELD>
<FIELD
KEY="owner_street">address</FIELD>
<FIELD
KEY="owner_city">city</FIELD>
<FIELD
KEY="owner_state">state
AA</FIELD>
<FIELD
KEY="owner_zip">zip</FIELD>
<FIELD
KEY="owner_country">country
AA</FIELD>
<FIELD
KEY="owner_email">Email
of customer </FIELD>
# not
required
<FIELD
KEY="owner_phone">Phone
of customer</FIELD>
# not
required
<FIELD
KEY="recurring">0-no
1-yes</FIELD>
<FIELD
KEY="recurring_type">Null
if recurring
=0</FIELD>
<FIELD
KEY=”remote_ip_address”>Customer
IP Address</FIELD>
# not
required
</FIELDS>
</TRANSACTION> |
What is the
response that I get back from the
XMLGateway (for operation_type
auth or sale)?
<?xml
version="1.0"
encoding="UTF-8"?>
<RESPONSE>
<FIELDS>
<FIELD
KEY="status">0-error
1-success
2-declined</FIELD>
<FIELD
KEY="auth_code">character
code sent by the bank
</FIELD>
<FIELD
KEY="auth_response">message
from the bank
</FIELD>
<FIELD
KEY="avs_code">avs code
from the
bank</FIELD>
<FIELD
KEY="cvv2_code">cvv2
code from the
bank</FIELD>
<FIELD
KEY="order_id">echoed
back from original
post</FIELD>
<FIELD
KEY="reference_number">returned
for use with
credits/voids/settles</FIELD>
<FIELD
KEY="error">error
text</FIELD>
</FIELDS>
</RESPONSE> |
** NOTE
**
recurring_type
options:
daily, weekly, biweekly,
monthly, quarterly,
semiannually, annually
order_id options:
only these characters are
accepted: a-z, A-Z, 0-9, @,
hyphen (-), space, comma (,),
and a period (.).
There is also a length
restriction with a low limit of
1 and a max of 50
characters.
operation types:
auth - just gets the
card authorized it does not
settle the transaction.
sale - authorizes the
card and settles the
transaction.
|
