Merchant e-Solutions
Payment Gateway
FX Processing
Merchant e-Solutions
October 2008
Version 1.3
© This publication is for information purposes only and its content does not represent a
contract in any form. Furthermore, this publication shall not be deemed to be a warranty
of any kind, either express or implied. Merchant e-Solutions expressly disclaims, and you
expressly waive, any and all warranties, including without limitation those of
merchantability and fitness for a particular purpose. Merchant e-Solutions reserves the
right to alter product specifications without notice. No part of this publication may be
reproduced or transmitted in any form or by any means, electronic or mechanical,
including photocopy, recording, or any information storage or retrieval system, without
Merchant e-Solutions permission.
Trident Payment Systems
 Merchant e-Solutions 2008
MasterCard® is a federally registered trademark of MasterCard International, Inc.
Visa® is a federally registered trademark of Visa, U.S.A., Inc.
ZIP code® and ZIP + 4® are federally registered trademarks of the United States Postal
Service.
Table of Contents
Chapter 1 – Related Documentation ................................................................................... 2
1.1 Applicable documents .......................................................................................... 2
1.2 Related documents ................................................................................................. 2
1.3 Document revisions ................................................................................................. 2
Chapter 2 – Overview .......................................................................................................... 3
2.1 Introduction .............................................................................................................. 3
Chapter 3 – Transaction Flow ............................................................................................. 4
3.1 Sale ......................................................................................................................... 4
3.2 Refund ..................................................................................................................... 4
3.3 Chargeback ............................................................................................................. 5
Chapter 4 – Foreign Exchange (FX) Request/Response Fields ......................................... 7
4.1 Request and Response Fields ................................................................................ 7
Chapter 5 – Foreign Exchange (FX) Transaction Types ..................................................... 8
5.1 Transaction Types ................................................................................................... 8
Chapter 6 – Foreign Exchange (FX) Error Codes ............................................................... 9
6.1 Error Codes ............................................................................................................. 9
Chapter 7 – Foreign Exchange (FX) Validations ............................................................... 10
7.1 Validations ............................................................................................................. 10
Chapter 8 - Source Code Samples ................................................................................... 11
8.1 Currency Lookup - Bad Country Code .................................................................. 11
8.2 Currency Lookup - Germany ................................................................................. 11
8.3 Currency Lookup - Canada ................................................................................... 11
8.4 Convert Amount - Euro (alpha) - missing amount ................................................. 11
8.5 Convert Amount - Euro (alpha) ............................................................................. 11
8.6 Convert Amount - Euro (numeric) ......................................................................... 12
8.7 Convert Amount - Yen (alpha) ............................................................................... 12
8.8 Rate Lookup - Canadian Dollar (alpha) ................................................................. 12
8.9 Rate Lookup - Euro (numeric) ............................................................................... 12
8.10 Rate Lookup - Full Rate Table ............................................................................ 13
8.11 Pre-Auth - Euro (numeric) - missing fx amount ................................................... 14
8.12 Pre-Auth - Euro (numeric) - missing rate id ......................................................... 14
8.13 Pre-Auth - Euro (numeric) - expired rate id ......................................................... 15
8.14 Pre-Auth - Euro (numeric) - foreign amount & base amount inconsistent........... 15
8.15 Pre-Auth - Euro (numeric) ................................................................................... 15
8.16 Settlement of a Pre-Auth - partial ........................................................................ 15
8.17 Immediate Sale ................................................................................................... 15
8.18 Refund ................................................................................................................. 16
8.19 United Kingdom, GBP ......................................................................................... 16
8.20 Netherlands, EUR ............................................................................................... 16
8.21 United States, USD ............................................................................................. 16
8.22 Canada, CAD ...................................................................................................... 16
Payment Gateway v2.3
©2008 Merchant e-Solutions, Inc.
1
Chapter 1 – Related Documentation
1.1 Applicable documents
This document describes the process for International credit card transactions, as well as
foreign currency conversion within the Merchant e-Solutions (MeS) Payment Gateway
Application Programming Interface (API). The following documents provide additional
definition and background information. Please refer to the related documents listed for
applicable information.
1.2 Related documents
Message Protocol Management
Revision /
generation
VMP1
MeS Back Office User Guide
V2.0
MeS Payment Gateway
Specifications
V2.6
Name
Related topic
Converts existing gateway protocols
User Guide to Gateway Back Office
Functionality
Core specification document
1.3 Document revisions
Chapter
Action
4
Update
Data
4.1, updated comments section for fx_amount
field
Payment Gateway v2.3
©2008 Merchant e-Solutions, Inc.
2
Chapter 2 – Overview
2.1 Introduction
The Merchant e-Solutions (MeS) Payment Gateway processes both U.S. and
International credit cards transactions. In addition, the gateway facilitates foreign
currency conversion. This process allows the merchant to present a transaction amount
to their customer in their native currency while funding for the merchant remains in U.S.
dollars.
In addition, the currency conversion is set at a guaranteed rate and stays with the life of
the transaction enabling refunds and chargeback’s to be processed at the original amount
of sale. Locking in a rate protects the merchant from fluctuating world currencies which in
turn allows the merchant to operate in an efficient financial environment.
The currency conversion table is available for download via the MeS Payment Gateway.
Once loaded on the merchant’s system it is then used to present a price to the customer.
The table contains the hedge (markup) that is paid by the cardholder.
When a transaction is submitted for authorization, the rate ID associated with the rate
table must be presented. The MeS Payment Gateway will then validate that the rate ID is
valid prior to submitting for authorization. If the rate ID is invalid or has expired, an error
message will be returned indicating the rate ID is invalid or expired. This validation
ensures that the rate submitted will be guaranteed throughout the life of the transaction.
This document is intended to:
Offer a basic understanding of foreign exchange processing
Provide the specific technical information needed to submit a successful request and
receive and interpret the resulting responses for presenting a specific currency amount to
an end user.
Payment Gateway v2.3
©2008 Merchant e-Solutions, Inc.
3
Chapter 3 – Transaction Flow
3.1 Sale
The following flow chart describes the transaction flow for a sale using the Merchant eSolutions (MeS) FX service.
3.2 Refund
The following flow chart describes the transaction flow for a refund using the Merchant eSolutions (MeS) FX service.
Payment Gateway v2.3
©2008 Merchant e-Solutions, Inc.
4
3.3 Chargeback
The following flow chart describes the transaction flow for a refund using the Merchant eSolutions (MeS) FX service.
Payment Gateway v2.3
©2008 Merchant e-Solutions, Inc.
5
Payment Gateway v2.3
©2008 Merchant e-Solutions, Inc.
6
Chapter 4 – Foreign Exchange (FX) Request/Response Fields
4.1 Request and Response Fields
The following table contains Responses and Requests you may receive from the MeS
Payment Gateway.
Field Name
transaction_type
fx_amount
Description
Foreign
exchange (FX)
transaction type
The amount of
the transaction in
the merchant
base currency.
Length
Format
Comments
1
A
See transaction type table below
Required for Immediate Sale (D), PreAuthorization (P), Settle Pre-Auth (S),
Refund (U), Credit (C), and FX Amount
Conversion (F) transaction types.
12
N
This field contains the amount the
merchant expects to receive in the base
currency.
A full refund may be submitted without the
fx_amount, however it is required for partial
refunds.
fx_rate_id
FX Rate Table ID
10
N
This field will be returned by a Get Rate
(G) request for a specific currency code.
fx_rate
fx_rate_table
FX Rate Data
FX Rate Table
VAR
VAR
XML
XML
The value of this field will be URL
encoded.
This field will be returned by a Get Rate
(G) request where a currency code is not
specified. This field will contain all the
rates available for the merchant account.
The value of this field will be URL
encoded.
This field is returned by a successful FX
Convert Amount (F) request.
Format: MM/dd/yyyyhh24:mm:ssZZZ
(no spaces)
fx_expiration_date
FX Rate Table
Expiration Date
23
TS
error_code
3-character error
code providing
additional detail
3
N
MM: 2-digit month
dd: day of the month
yyyy: year
hh24: hour in 24-hour format (0-23)
mm: minute
ss: second
ZZZ: time zone (example PST)
See error code table below
Payment Gateway v2.3
©2008 Merchant e-Solutions, Inc.
7
Chapter 5 – Foreign Exchange (FX) Transaction Types
5.1 Transaction Types
The following table contains Transaction Types for the MeS Payment Gateway.
Tran Type
Description
Comments
Use this command to convert an amount in the base currency to the
specified currency.
F
FX Convert Amount
G
Get Rate(s)
L
Lookup Currency
Code
This command returns the converted amount in transaction_amount,
the rate table id used in fx_rate_id and the rate table expiration date
in fx_expiration_date.
Use this command to retrieve an individual currency rate or all the
rates. Use the currency_code parameter in the request to receive a
single rate.
Given a valid country code OR IP address this method returns the
currency code.
Payment Gateway v2.3
©2008 Merchant e-Solutions, Inc.
8
Chapter 6 – Foreign Exchange (FX) Error Codes
6.1 Error Codes
The following table contains Error Codes you may receive from the MeS Payment
Gateway.
Code
Error Description
Required Action
224
FX rate ID invalid.
225
FX rate table has expired.
226
FX rate lookup failed, retry request.
227
FX rate ID required for foreign currency
transactions.
Retry the transaction with a valid rate table ID.
Converted amounts do no match FX
rate.
Using the rate table requested, the fx_amount (in
the base currency) does not match the
transaction_amount (in cardholder currency). Retry
the request with an updated transaction_amount or
fx_amount.
228
229
230
231
Failed to find currency code for the
requested country code.
Failed to post transaction the FX
service.
FX amount in base currency is required.
Retry with a valid rate ID.
Request a new rate table id for the currency, then
retry the request with the valid rate table id.
The system failed to lookup the specified rate id.
Retry the request.
Retry request.
Never returned by the API.
Retry request with a valid fx_amount.
Payment Gateway v2.3
©2008 Merchant e-Solutions, Inc.
9
Chapter 7 – Foreign Exchange (FX) Validations
7.1 Validations
The following additional validations will be performed on the Immediate Sale(D),PreAuthorization(P), Settle Pre-Auth (S), Refund (U), Credit (C), and FX Amount Conversion
(F) transaction types:
A valid fx_rate_id is required for all non-US currency transactions for D and P
transactions.
A fx_amount is required for all non-US currency transactions. This amount must be in the
base currency.
If both a rate_id and a currency_code (optional) are provided the two must be consistent.
The transaction_amount and the fx_amount must be consistent with the rate specified by
the fx_rate_id.
The following validations will be performed on the Get Rate(G) transaction type:
If a currency_code (optional) is provided it must be a valid currency for the merchant.
The following validations will be performed on the FX Convert Amount(F) transaction
type:
fx_amount is required.
currency_code OR ip_address is required. The currency requested must be supported
by the merchant.
Payment Gateway v2.3
©2008 Merchant e-Solutions, Inc.
10
Chapter 8 - Source Code Samples
This section contains source code samples.
8.1 Currency Lookup - Bad Country Code
Request Params:
profile_id=94100005777800000001&profile_key=CwWuixEDHUChjASTJDkrqrXwu
lGfKOlL&transaction_type=L&country_code=BAD
Response:
transaction_id=error&error_code=229&auth_response_text=Failed to find
currency code for the requested country code.
8.2 Currency Lookup - Germany
Request Params:
profile_id=94100005777800000001&profile_key=CwWuixEDHUChjASTJDkrqrXwu
lGfKOlL&transaction_type=L&country_code=DE
Response:
transaction_id=55b19c7ff83c3fa5a4ab69b3f5b5cf49&error_code=000&auth_r
esponse_text=Request
Complete&currency_code=978&currency_code_alpha=EUR
8.3 Currency Lookup - Canada
Request Params:
profile_id=94100005777800000001&profile_key=CwWuixEDHUChjASTJDkrqrXwu
lGfKOlL&transaction_type=L&country_code=CA
Response:
transaction_id=ad9ab23ec9d330d7a2f4d7711c267d5c&error_code=000&auth_r
esponse_text=Request
Complete&currency_code=124&currency_code_alpha=CAD
8.4 Convert Amount - Euro (alpha) - missing amount
Request Params:
profile_id=94100005777800000001&profile_key=CwWuixEDHUChjASTJDkrqrXwu
lGfKOlL&transaction_type=F&currency_code=EUR
Response:
transaction_id=error&error_code=231&auth_response_text=FX amount in
base currency is required.
8.5 Convert Amount - Euro (alpha)
Request Params:
profile_id=94100005777800000001&profile_key=CwWuixEDHUChjASTJDkrqrXwu
lGfKOlL&transaction_type=F&currency_code=EUR&fx_amount=50
Response:
transaction_id=63959052599e3be8902a01807064b810&error_code=000&auth_r
esponse_text=Request
Complete&fx_rate_id=32815&fx_expiration_date=01/16/2008 00:45:00
PST&transaction_amount=36.00
Payment Gateway v2.3
©2008 Merchant e-Solutions, Inc.
11
8.6 Convert Amount - Euro (numeric)
Request Params:
profile_id=94100005777800000001&profile_key=CwWuixEDHUChjASTJDkrqrXwu
lGfKOlL&transaction_type=F&currency_code=978&fx_amount=50
Response:
transaction_id=024a2a3f31b23105bc996638ef829368&error_code=000&auth_r
esponse_text=Request
Complete&fx_rate_id=32815&fx_expiration_date=01/16/2008 00:45:00
PST&transaction_amount=36.00
8.7 Convert Amount - Yen (alpha)
Request Params:
profile_id=94100005777800000001&profile_key=CwWuixEDHUChjASTJDkrqrXwu
lGfKOlL&transaction_type=F&currency_code=JPY&fx_amount=50
Response:
transaction_id=813e142521cb386aa15fc9e04593edc2&error_code=000&auth_r
esponse_text=Request
Complete&fx_rate_id=32819&fx_expiration_date=01/16/2008 00:45:00
PST&transaction_amount=5781
8.8 Rate Lookup - Canadian Dollar (alpha)
Request Params:
profile_id=94100005777800000001&profile_key=CwWuixEDHUChjASTJDkrqrXwu
lGfKOlL&transaction_type=G&currency_code=CAD
Response:
transaction_id=36032832cedf38d985fef12dbcb57a22&error_code=000&auth_r
esponse_text=Request
Complete&fx_rate=%3C%3Fxml+version%3D%221.0%22+encoding%3D%22ISO88591%22%3F%3E%0D%0A%3CFXRate%3E%0D%0A+%3CRateId%3E32809%3C%2FRateId%3E%0
D%0A+%3CMerchantCurrencyCode%3EUSD%3C%2FMerchantCurrencyCode%3E%0D%0A
+%3CConsumerCurrencyCode%3ECAD%3C%2FConsumerCurrencyCode%3E%0D%0A+%3C
ConsumerCurrencyCountry%3ECanada%3C%2FConsumerCurrencyCountry%3E%0D%0
A+%3CConsumerCurrencyDesc%3ECanadian+Dollar%3C%2FConsumerCurrencyDesc
%3E%0D%0A+%3CExpirationDate%3E01%2F16%2F2008+00%3A45%3A00+PST%3C%2FEx
pirationDate%3E%0D%0A+%3CRate%3E1.0594%3C%2FRate%3E%0D%0A%3C%2FFXRate
%3E%0D%0A
8.9 Rate Lookup - Euro (numeric)
Request Params:
profile_id=94100005777800000001&profile_key=CwWuixEDHUChjASTJDkrqrXwu
lGfKOlL&transaction_type=G&currency_code=978
Response:
transaction_id=a16b75418cc0313b9d8f1d1e28c09bed&error_code=000&auth_r
esponse_text=Request
Complete&fx_rate=%3C%3Fxml+version%3D%221.0%22+encoding%3D%22ISO88591%22%3F%3E%0D%0A%3CFXRate%3E%0D%0A+%3CRateId%3E32815%3C%2FRateId%3E%0
D%0A+%3CMerchantCurrencyCode%3EUSD%3C%2FMerchantCurrencyCode%3E%0D%0A
+%3CConsumerCurrencyCode%3EEUR%3C%2FConsumerCurrencyCode%3E%0D%0A+%3C
Payment Gateway v2.3
©2008 Merchant e-Solutions, Inc.
12
ConsumerCurrencyCountry%3EEuro+Member+Countries%3C%2FConsumerCurrency
Country%3E%0D%0A+%3CConsumerCurrencyDesc%3EEuro%3C%2FConsumerCurrency
Desc%3E%0D%0A+%3CExpirationDate%3E01%2F16%2F2008+00%3A45%3A00+PST%3C%
2FExpirationDate%3E%0D%0A+%3CRate%3E0.7201%3C%2FRate%3E%0D%0A%3C%2FFX
Rate%3E%0D%0A
8.10 Rate Lookup - Full Rate Table
Request Params:
profile_id=94100005777800000001&profile_key=CwWuixEDHUChjASTJDkrqrXwu
lGfKOlL&transaction_type=G
Response:
transaction_id=error&error_code=000&auth_response_text=&fx_rate_table
=%3C%3Fxml+version%3D%221.0%22+encoding%3D%22ISO-88591%22%3F%3E%0D%0A%3CFXRateTable%3E%0D%0A+%3CFXRate%3E%0D%0A++%3CRateId
%3E32807%3C%2FRateId%3E%0D%0A++%3CMerchantCurrencyCode%3EUSD%3C%2FMer
chantCurrencyCode%3E%0D%0A++%3CConsumerCurrencyCode%3EAUD%3C%2FConsum
erCurrencyCode%3E%0D%0A++%3CConsumerCurrencyCountry%3EAustralia%3C%2F
ConsumerCurrencyCountry%3E%0D%0A++%3CConsumerCurrencyDesc%3EDollar%3C
%2FConsumerCurrencyDesc%3E%0D%0A++%3CExpirationDate%3E01%2F16%2F2008+
00%3A45%3A00+PST%3C%2FExpirationDate%3E%0D%0A++%3CRate%3E1.2156%3C%2F
Rate%3E%0D%0A+%3C%2FFXRate%3E%0D%0A+%3CFXRate%3E%0D%0A++%3CRateId%3E3
2809%3C%2FRateId%3E%0D%0A++%3CMerchantCurrencyCode%3EUSD%3C%2FMerchan
tCurrencyCode%3E%0D%0A++%3CConsumerCurrencyCode%3ECAD%3C%2FConsumerCu
rrencyCode%3E%0D%0A++%3CConsumerCurrencyCountry%3ECanada%3C%2FConsume
rCurrencyCountry%3E%0D%0A++%3CConsumerCurrencyDesc%3ECanadian+Dollar%
3C%2FConsumerCurrencyDesc%3E%0D%0A++%3CExpirationDate%3E01%2F16%2F200
8+00%3A45%3A00+PST%3C%2FExpirationDate%3E%0D%0A++%3CRate%3E1.0594%3C%
2FRate%3E%0D%0A+%3C%2FFXRate%3E%0D%0A+%3CFXRate%3E%0D%0A++%3CRateId%3
E32810%3C%2FRateId%3E%0D%0A++%3CMerchantCurrencyCode%3EUSD%3C%2FMerch
antCurrencyCode%3E%0D%0A++%3CConsumerCurrencyCode%3ECHF%3C%2FConsumer
CurrencyCode%3E%0D%0A++%3CConsumerCurrencyCountry%3ESwitzerland%3C%2F
ConsumerCurrencyCountry%3E%0D%0A++%3CConsumerCurrencyDesc%3ESwitzerla
nd+Franc%3C%2FConsumerCurrencyDesc%3E%0D%0A++%3CExpirationDate%3E01%2
F16%2F2008+00%3A45%3A00+PST%3C%2FExpirationDate%3E%0D%0A++%3CRate%3E1
.1799%3C%2FRate%3E%0D%0A+%3C%2FFXRate%3E%0D%0A+%3CFXRate%3E%0D%0A++%3
CRateId%3E32813%3C%2FRateId%3E%0D%0A++%3CMerchantCurrencyCode%3EUSD%3
C%2FMerchantCurrencyCode%3E%0D%0A++%3CConsumerCurrencyCode%3EDKK%3C%2
FConsumerCurrencyCode%3E%0D%0A++%3CConsumerCurrencyCountry%3EDenmark%
3C%2FConsumerCurrencyCountry%3E%0D%0A++%3CConsumerCurrencyDesc%3EKron
e%3C%2FConsumerCurrencyDesc%3E%0D%0A++%3CExpirationDate%3E01%2F16%2F2
008+00%3A45%3A00+PST%3C%2FExpirationDate%3E%0D%0A++%3CRate%3E5.3648%3
C%2FRate%3E%0D%0A+%3C%2FFXRate%3E%0D%0A+%3CFXRate%3E%0D%0A++%3CRateId
%3E32815%3C%2FRateId%3E%0D%0A++%3CMerchantCurrencyCode%3EUSD%3C%2FMer
chantCurrencyCode%3E%0D%0A++%3CConsumerCurrencyCode%3EEUR%3C%2FConsum
erCurrencyCode%3E%0D%0A++%3CConsumerCurrencyCountry%3EEuro+Member+Cou
ntries%3C%2FConsumerCurrencyCountry%3E%0D%0A++%3CConsumerCurrencyDesc
%3EEuro%3C%2FConsumerCurrencyDesc%3E%0D%0A++%3CExpirationDate%3E01%2F
16%2F2008+00%3A45%3A00+PST%3C%2FExpirationDate%3E%0D%0A++%3CRate%3E0.
7201%3C%2FRate%3E%0D%0A+%3C%2FFXRate%3E%0D%0A+%3CFXRate%3E%0D%0A++%3C
RateId%3E32816%3C%2FRateId%3E%0D%0A++%3CMerchantCurrencyCode%3EUSD%3C
%2FMerchantCurrencyCode%3E%0D%0A++%3CConsumerCurrencyCode%3EGBP%3C%2F
ConsumerCurrencyCode%3E%0D%0A++%3CConsumerCurrencyCountry%3EUnited+Ki
ngdom%3C%2FConsumerCurrencyCountry%3E%0D%0A++%3CConsumerCurrencyDesc%
3EBritish+Pound%3C%2FConsumerCurrencyDesc%3E%0D%0A++%3CExpirationDate
%3E01%2F16%2F2008+00%3A45%3A00+PST%3C%2FExpirationDate%3E%0D%0A++%3CR
Payment Gateway v2.3
©2008 Merchant e-Solutions, Inc.
13
ate%3E0.5373%3C%2FRate%3E%0D%0A+%3C%2FFXRate%3E%0D%0A+%3CFXRate%3E%0D
%0A++%3CRateId%3E32817%3C%2FRateId%3E%0D%0A++%3CMerchantCurrencyCode%
3EUSD%3C%2FMerchantCurrencyCode%3E%0D%0A++%3CConsumerCurrencyCode%3EH
KD%3C%2FConsumerCurrencyCode%3E%0D%0A++%3CConsumerCurrencyCountry%3EH
ong+Kong%3C%2FConsumerCurrencyCountry%3E%0D%0A++%3CConsumerCurrencyDe
sc%3EDollar%3C%2FConsumerCurrencyDesc%3E%0D%0A++%3CExpirationDate%3E0
1%2F16%2F2008+00%3A45%3A00+PST%3C%2FExpirationDate%3E%0D%0A++%3CRate%
3E8.2709%3C%2FRate%3E%0D%0A+%3C%2FFXRate%3E%0D%0A+%3CFXRate%3E%0D%0A+
+%3CRateId%3E32819%3C%2FRateId%3E%0D%0A++%3CMerchantCurrencyCode%3EUS
D%3C%2FMerchantCurrencyCode%3E%0D%0A++%3CConsumerCurrencyCode%3EJPY%3
C%2FConsumerCurrencyCode%3E%0D%0A++%3CConsumerCurrencyCountry%3EJapan
%3C%2FConsumerCurrencyCountry%3E%0D%0A++%3CConsumerCurrencyDesc%3EYen
%3C%2FConsumerCurrencyDesc%3E%0D%0A++%3CExpirationDate%3E01%2F16%2F20
08+00%3A45%3A00+PST%3C%2FExpirationDate%3E%0D%0A++%3CRate%3E115.6248%
3C%2FRate%3E%0D%0A+%3C%2FFXRate%3E%0D%0A+%3CFXRate%3E%0D%0A++%3CRateI
d%3E32823%3C%2FRateId%3E%0D%0A++%3CMerchantCurrencyCode%3EUSD%3C%2FMe
rchantCurrencyCode%3E%0D%0A++%3CConsumerCurrencyCode%3ENOK%3C%2FConsu
merCurrencyCode%3E%0D%0A++%3CConsumerCurrencyCountry%3ENorway%3C%2FCo
nsumerCurrencyCountry%3E%0D%0A++%3CConsumerCurrencyDesc%3ENorway+Kron
e%3C%2FConsumerCurrencyDesc%3E%0D%0A++%3CExpirationDate%3E01%2F16%2F2
008+00%3A45%3A00+PST%3C%2FExpirationDate%3E%0D%0A++%3CRate%3E5.6685%3
C%2FRate%3E%0D%0A+%3C%2FFXRate%3E%0D%0A+%3CFXRate%3E%0D%0A++%3CRateId
%3E32824%3C%2FRateId%3E%0D%0A++%3CMerchantCurrencyCode%3EUSD%3C%2FMer
chantCurrencyCode%3E%0D%0A++%3CConsumerCurrencyCode%3ENZD%3C%2FConsum
erCurrencyCode%3E%0D%0A++%3CConsumerCurrencyCountry%3ENew+Zealand%3C%
2FConsumerCurrencyCountry%3E%0D%0A++%3CConsumerCurrencyDesc%3ENew+Zea
land+Dollar%3C%2FConsumerCurrencyDesc%3E%0D%0A++%3CExpirationDate%3E0
1%2F16%2F2008+00%3A45%3A00+PST%3C%2FExpirationDate%3E%0D%0A++%3CRate%
3E1.3867%3C%2FRate%3E%0D%0A+%3C%2FFXRate%3E%0D%0A+%3CFXRate%3E%0D%0A+
+%3CRateId%3E32827%3C%2FRateId%3E%0D%0A++%3CMerchantCurrencyCode%3EUS
D%3C%2FMerchantCurrencyCode%3E%0D%0A++%3CConsumerCurrencyCode%3ESEK%3
C%2FConsumerCurrencyCode%3E%0D%0A++%3CConsumerCurrencyCountry%3ESwede
n%3C%2FConsumerCurrencyCountry%3E%0D%0A++%3CConsumerCurrencyDesc%3EKr
ono%3C%2FConsumerCurrencyDesc%3E%0D%0A++%3CExpirationDate%3E01%2F16%2
F2008+00%3A45%3A00+PST%3C%2FExpirationDate%3E%0D%0A++%3CRate%3E6.7498
%3C%2FRate%3E%0D%0A+%3C%2FFXRate%3E%0D%0A%3C%2FFXRateTable%3E%0D%0A
8.11 Pre-Auth - Euro (numeric) - missing fx amount
Request Params:
profile_id=94100005777800000001&profile_key=CwWuixEDHUChjASTJDkrqrXwu
lGfKOlL&transaction_type=P&card_number=4907639999990022&card_exp_date
=1210&transaction_amount=36.00&invoice_number=12345&cvv2=029&currency
_code=978
Response:
transaction_id=error&error_code=231&auth_response_text=FX amount in
base currency is required.
8.12 Pre-Auth - Euro (numeric) - missing rate id
Request Params:
profile_id=94100005777800000001&profile_key=CwWuixEDHUChjASTJDkrqrXwu
lGfKOlL&transaction_type=P&card_number=4907639999990022&card_exp_date
=1210&transaction_amount=36.00&invoice_number=12345&cvv2=029&currency
_code=978&fx_amount=50.00
Response:
Payment Gateway v2.3
©2008 Merchant e-Solutions, Inc.
14
transaction_id=error&error_code=227&auth_response_text=FX rate ID
required for foreign currency transactions.
8.13 Pre-Auth - Euro (numeric) - expired rate id
Request Params:
profile_id=94100005777800000001&profile_key=CwWuixEDHUChjASTJDkrqrXwu
lGfKOlL&transaction_type=P&card_number=4907639999990022&card_exp_date
=1210&transaction_amount=36.00&invoice_number=12345&cvv2=029&currency
_code=978&fx_amount=50.00&fx_rate_id=31315
Response:
transaction_id=error&error_code=225&auth_response_text=FX rate has
expired.
8.14 Pre-Auth - Euro (numeric) - foreign amount & base amount
inconsistent
Request Params:
profile_id=94100005777800000001&profile_key=CwWuixEDHUChjASTJDkrqrXwu
lGfKOlL&transaction_type=P&card_number=4907639999990022&card_exp_date
=1210&transaction_amount=32.00&invoice_number=12345&cvv2=029&currency
_code=978&fx_amount=50.00&fx_rate_id=32815
Response:
transaction_id=error&error_code=228&auth_response_text=Base and
consumer amounts are inconsistent with the FX rate.
8.15 Pre-Auth - Euro (numeric)
Request Params:
profile_id=94100005777800000001&profile_key=CwWuixEDHUChjASTJDkrqrXwu
lGfKOlL&transaction_type=P&card_number=4907639999990022&card_exp_date
=1210&transaction_amount=36.00&invoice_number=12345&cvv2=029&currency
_code=978&fx_amount=50.00&fx_rate_id=32815
Response:
transaction_id=cf0d560aa04f4bdda030571cde4992ca&error_code=000&auth_r
esponse_text=OK
8.16 Settlement of a Pre-Auth - partial
Request Params:
profile_id=94100005777800000001&profile_key=CwWuixEDHUChjASTJDkrqrXwu
lGfKOlL&transaction_type=S&transaction_id=cf0d560aa04f4bdda030571cde4
992ca&transaction_amount=25.00&fx_amount=40.00
Response:
transaction_id=cf0d560aa04f4bdda030571cde4992ca&error_code=000&auth_r
esponse_text=Settle Request Accepted
8.17 Immediate Sale
Request Params:
profile_id=94100005777800000001&profile_key=CwWuixEDHUChjASTJDkrqrXwu
lGfKOlL&transaction_type=D&card_number=4907639999990022&card_exp_date
=1210&transaction_amount=35.99&invoice_number=12345&cvv2=029&currency
_code=978&fx_amount=50.00&fx_rate_id=33819
Payment Gateway v2.3
©2008 Merchant e-Solutions, Inc.
15
Response:
transaction_id=78afe0adbb9146548561b7d6e4ab55e8&error_code=000&auth_r
esponse_text=OK
8.18 Refund
Request Params:
profile_id=94100005777800000001&profile_key=CwWuixEDHUChjASTJDkrqrXwu
lGfKOlL&transaction_type=U&transaction_id=78afe0adbb9146548561b7d6e4a
b55e8
Response:
transaction_id=78afe0adbb9146548561b7d6e4ab55e8&error_code=000&auth_r
esponse_text=Refund Request Accepted - Refund
8.19 United Kingdom, GBP
profile_id=94100005777800000001&profile_key=CwWuixEDHUChjASTJDkrqrXwu
lGfKOlL&transaction_type=L&ip_address=212.187.153.30
8.20 Netherlands, EUR
profile_id=94100005777800000001&profile_key=CwWuixEDHUChjASTJDkrqrXwu
lGfKOlL&transaction_type=L&ip_address=212.41.142.72
8.21 United States, USD
profile_id=94100005777800000001&profile_key=CwWuixEDHUChjASTJDkrqrXwu
lGfKOlL&transaction_type=L&ip_address=63.100.168.195
8.22 Canada, CAD
profile_id=94100005777800000001&profile_key=CwWuixEDHUChjASTJDkrqrXwu
lGfKOlL&transaction_type=L&country_code=CA
Payment Gateway v2.3
©2008 Merchant e-Solutions, Inc.
16