Xpress Money - API - 2.0 Manadtory PDF

XPRESS MONEY | API
WEB SERVICES
TRAINING | PROCESS REENGINEERING

Version 2.0 - Dec 2014
Disclaimer:
All rights reserved. These materials are confidential and proprietary of Xpress Money Services.
No part of the material should be reproduced, published in any form by any means (electronic or mechanical, including
photocopy or any information storage or retrieval system), nor should the materials be disclosed to third parties without
the express written authorization of Xpress Money Services.
Prepared by Training & PRE

www.xpressmoney.com
Table of Contents
ABOUT US .......................................................................................................................................................... 3
‘HOW’ WE DO ‘WHAT’ WE DO ........................................................................................................................... 4
Cash to Cash ................................................................................................................................................... 4
Account Credit ................................................................................................................................................. 4
Door Delivery ................................................................................................................................................... 5
E-Services ....................................................................................................................................................... 5
HOW IT WORKS ................................................................................................................................................. 5
API METHODS .................................................................................................................................................... 7
1. Send Remittance Methods ....................................................................................................................... 7
1.1 CreateXMTransaction Method .......................................................................................................... 7
1.2 EditXMTransaction Method.............................................................................................................. 11
1.3 ConfirmXMTransaction Method ....................................................................................................... 15
2. Receive Remittance Methods .................................................................................................................. 16
2.1 getAllOutstandingTransactions Method ............................................................................................ 16
2.2 updateAllOutstandingtxnlist Method ................................................................................................. 17
2.3 confirmAllOutstandingReceiveTxn Method ....................................................................................... 18
2.4 getXMReceiveTxn Method............................................................................................................... 19
2.5 confirmXMReceiveTxn Method ........................................................................................................ 21
3. Cancel Remittance Methods ................................................................................................................... 21
3.1 getXMSCancelTxn Method .............................................................................................................. 21
3.2 ConfirmXMSCancelTxn Method: ...................................................................................................... 23
4. Utility Methods ........................................................................................................................................ 24
4.1 getXMRateCalculateDetails Method: ............................................................................................... 24
4.2 getXMAgentDetails Method ............................................................................................................. 25
4.3 getXMCountryDetails Method .......................................................................................................... 26
4.4 getXMBankDetails Method .............................................................................................................. 27
4.5 GetXMXpinEnquiry Method ............................................................................................................. 28
4.6 GetXMXpinStatus Method: .............................................................................................................. 29
5. Amendment Methods..............................................................................................................................30
5.1 getXMTxnAmendment Method ............................................................................................................ 30
5.2 confirmXMTxnAmendment Method ..................................................................................................... 31
2
Xpress Money | API 2.0
www.xpressmoney.com
6. Glossary ................................................................................................................................................. 33
6.1 Status Codes ................................................................................................................................... 33
6.2 Error Codes: .................................................................................................................................... 34
6.3 Country Information ......................................................................................................................... 40
6.4 ID Types and ID Code ..................................................................................................................... 48
6.5 Purpose of Transaction.................................................................................................................... 50
6.6 Source of Income ............................................................................................................................ 51
7. Integration Life Cycle .............................................................................................................................. 52
CONTACT US .................................................................................................................................................... 52
3
www.xpressmoney.com
ABOUT US
Registered in the United Kingdom, Xpress Money Services Ltd was established in the year of 1999. Marking its
presence in more than 150 countries across the world and more than 170,000 convenient agent locations spread
around the globe.
Xpress Money is the fastest way the entire world transfers money with unmatched features for secure and
convenient transfer of money. With a very high growth rate of network, Xpress Money aims to be the global
leader in Instant Money Transfers.
Our aim is to provide a simple, fast and safe service that ensures our mission to become the world’s most
dependable instant money transfer brand holds its value at the work place with our employees, our partners
and all the way down to our customer
‘HOW’ WE DO ‘WHAT’ WE DO
With the support of several, prestigious banking and non-banking organizations we have a presence in many
corners of the world.
Xpress Money is also one of the few non-banking entities with a SWIFT membership which gives us the
credibility and reach that is unparalleled across the globe.
As technology and trends change, we will continue to roll out services that will be simple, fast and safe and will
deliver value all the way down to our customer.
PRODUCTS
Cash to Cash
Cash To Cash is our flagship offering, one of the most preferred and easy-to-use services, instant mode of
transferring money through a unique 16 digit reference number called the XPIN (Xpress Personal Identification
Number)
Beneficiary can collect the cash at the payout location by referring this XPIN number along with a valid personal
identification as verification
Account Credit
Account Credit is a mode of transferring money where in the money will be directly credited to the bank account
of the beneficiary as mentioned at the time of the transaction.
4
www.xpressmoney.com
Door Delivery
Door Delivery is an instant mode of transferring money wherein the money will be directly delivered to
the doorstep of the beneficiary as per the transaction address.
E-Services
E-services are the new mode of services recently introduced by Xpress Money. It consists of further two types:
1. Cash to Card – This service enables users to send money to Remittance card of the beneficiary.
2. Cash to Mobile – This service enables users to send money to a virtual mobile wallet of the beneficiary
HOW IT WORKS
How can customer send & receive money across the globe
TO SEND MONEY
Sender visits Xpress Money agent location. Submits valid id Selects a convenient payout mode
card and the Receiver’s details.
Hands over the amount to be sent and the transfer fee. Sender receives 16-digit XPIN number.
5
www.xpressmoney.com
Sender communicates the 16-digit XPIN number to the Receiver
How to Send Money

o Visit any Xpress Money send
agent o Fill out a send money form
o Make sure that the beneficiary’s name is spelt correctly o
Hand over amount to be transferred and transfer charges o
Give the beneficiary the unique 16 digit XPIN number
TO RECEIVE MONEY
Receiver visits the Xpress Money agent location / Bank / Submits valid id card and XPIN number.
ATM *applicable for cash payout & door delivery
*as per the selected payout mode
6
www.xpressmoney.com
Receives cash. Sender gets instant SMS notification upon collection

of cash by receiver.
How to Receive Money

o Visit the receive agent
o Hand over official photo ID
o Present 16 digit XPIN number
o Money is paid out in minutes
API METHODS
1. Send Remittance Methods
1.1 CreateXMTransaction Method
a. You can initiate a transaction in XM system using CreateXMTransaction method. Using this method, you
can initiate 5 different types of transactions which are Cash to Cash, Account Credit, Door Delivery,
Cash to Card and Cash to Mobile.
b. This method requires authentication details, sender – receiver details, and transaction details.
c. The method will return an XPIN in response which should be used for future reference.
d. Once CreateXMTransaction is success, ConfirmXMTransaction should be called to confirm
the transaction in XM System.
What is XPIN?
XPIN is a unique 16 digit reference number assigned to any transaction conducted using Xpress
Money network.
Sender needs to communicate this XPIN to the beneficiary in order to facilitate payout at the
receive location.
Request Field Description:
7
www.xpressmoney.com
Field Name Data Type Length Acceptable Characters
authenticationAgentCode char 12 Alpha Numeric (a-z, 0-9)
userID char 16 Alpha Numeric (a-z, 0-9)
password char 30 Alpha Numeric (a-z, 0-9)
pin char 10 Alpha Numeric (a-z, 0-9)
agentTxnRefNo char 20 Alpha Numeric (a-z, 0-9)
deliveryOption char 2 Alpha(a-z)
customerFirstName char 60 Alpha(a-z)
customerMiddleName char 60 Alpha(a-z)
customerLastName char 60 Alpha(a-z)
customerPOBox char 60 Numeric (0-9)
customerAddress1 char 60 Alpha Numeric (a-z, 0-9) Special Char
customerAddress2 char 60 Alpha Numeric (a-z, 0-9) Special Char
customerAddressCity char 60 Alpha(a-z)
customerAddressState char 60 Alpha(a-z)
customerAddressCountryCode char 2 Alpha(a-z)
customerAddressZip char 10 Alpha Numeric (a-z, 0-9)
customerPrimaryContactCountryCode char 6 Numeric (0-9)
customerPrimaryContactNo char 20 Numeric (0-9)
customerPrimaryContactNoType int Numeric (0-9)
customerSecContactCountryCode char 6 Numeric (0-9)
customerSecContactNo char 40 Numeric (0-9)
customerSecContactNoType int Numeric (0-9)
CustomerSmsNotify int Numeric (0-9)
customerOtherInfo char 40 Alpha Numeric (a-z, 0-9) Special Char
customerDescription char 60 Alpha Numeric (a-z, 0-9) Special Char
customerEmail char 40 Alpha Numeric (a-z, 0-9) Special Char
customerNationalityCode char 2 Alpha(a-z)
sourceOfIncome char 20 Alpha(a-z)
purposeOfTxn char 20 Alpha(a-z)
customerIDType int Numeric (0-9)
customerIDOtherType char 20 Alpha Numeric (a-z, 0-9)
customerID char 25 Alpha Numeric (a-z, 0-9)
customerIDIssuedBy char 60 Alpha Numeric (a-z, 0-9)
customerIDIssuedAt char 50 Alpha Numeric (a-z, 0-9)
8
www.xpressmoney.com
customerIDIssueDate datetime Numeric (0-9) -
customerIDValidThru datetime Numeric (0-9) -
customerDateOfBirth datetime Numeric (0-9) -
customerIDIssuanceCountry char 2 Alpha(a-z)
customerProofOfAddress char 3 Alpha Numeric (a-z, 0-9)
customerSecondaryIDType int Numeric (0-9)
customerSecondaryIDNo char 20 Alpha Numeric (a-z, 0-9)
customerSecondaryIDIssuedBy char 60 Alpha Numeric (a-z, 0-9)
customerSecondaryIDIssuedAt char 60 Alpha Numeric (a-z, 0-9)
customerSecIDIssuanceCountry char 2 Alpha(a-z)
customerSecondaryIDIssueDate datetime Numeric (0-9) -
customerSecondaryIDValidThru datetime Numeric (0-9) -
customerPlaceOfBirth char 60 Alpha(a-z)
customerOccupation char 40 Alpha Numeric (a-z, 0-9)
customerGender char 1 Alpha(a-z)
customerEmployerName char 60 Alpha(a-z)
customerEmployerPhoneCountryCode char 6 Numeric (0-9)
customerEmployerPhone char 40 Numeric (0-9)
beneficiaryFirstName char 60 Alpha(a-z)
beneficiaryMiddleName char 60 Alpha(a-z)
beneficiaryLastName char 60 Alpha(a-z)
beneficiaryIDType int Numeric (0-9)
beneficiaryIDOtherType char 20 Alpha Numeric (a-z, 0-9)
beneficiaryID char 60 Alpha Numeric (a-z, 0-9)
beneficiaryPOBox char 10 Numeric (0-9)
beneficiaryAddress1 char 60 Alpha Numeric (a-z, 0-9) Special Char
beneficiaryAddressCity char 60 Alpha(a-z)
beneficiaryAddressState char 60 Alpha(a-z)
beneAddressCountryCode char 2 Alpha(a-z)
beneficiaryAddressZip char 60 Numeric (0-9)
beneficiaryPhoneCountryCode char 6 Numeric (0-9)
beneficiaryPhone char 40 Numeric (0-9)
beneficiaryMobileCountryCode char 6 Numeric (0-9)
beneficiaryMobile char 20 Numeric (0-9)
9
www.xpressmoney.com
beneficiaryNationalityCode char 2 Alpha(a-z)
beneficiaryTestQuestion char 100 Alpha Numeric (a-z, 0-9) Special Char
beneficiaryTestAnswer char 40 Alpha Numeric (a-z, 0-9) Special Char
messageToBeneficiary char 100 Alpha Numeric (a-z, 0-9) Special Char
beneficiaryRelationship char 60 Alpha(a-z)
xmCustomerNo char 16 Numeric (0-9)
xmLoyaltyNo char 12 Numeric (0-9)
promoCode char 16 Alpha Numeric (a-z, 0-9) Special Char
sendingAgentCode char 12 Alpha Numeric (a-z, 0-9)
receivingAgentCode char 12 Alpha Numeric (a-z, 0-9)
payoutCcyCode char 3 Alpha(a-z)
payinCcyCode char 3 Alpha(a-z)
amount Numeric 15,3 Numeric (0-9)
sendingAmountFlag char 6 Alpha Numeric (a-z, 0-9)
paymentMode char 2 Alpha Numeric (a-z, 0-9)
authorizationCode char 20 Alpha Numeric (a-z, 0-9)
accountName char 120 Alpha(a-z)
accountNo char 60 Numeric (0-9)
accountIBAN char 100 Alpha Numeric (a-z, 0-9)
accountAdditionalNo1 char 100 Numeric (0-9)
beneficiarySmsNotify int Numeric (0-9)
bankName char 100 Alpha(a-z)
bankCode char 12 Numeric (0-9)
bankBranchName char 100 Alpha(a-z)
mobileWalletCountryCode char 6 Numeric (0-9)
mobileWalletNo char 16 Numeric (0-9)
cardNumber char 20 Numeric (0-9)
cardType int Numeric (0-9)
mobileOrCardAddInfo1 char 60 Alpha Numeric (a-z, 0-9) Special Char
mobileOrCardAddInfo2 char 60 Alpha Numeric (a-z, 0-9) Special Char
10
www.xpressmoney.com
Response Field Description

returnCode
returnMsg
settlementRatePayinToPayout Numeric 15,8 Numeric (0-9)
otherCharges Numeric 10,3 Numeric (0-9)
payoutInSettlementCcy Numeric 15,3 Numeric (0-9)
settlementCcyCode char 3 Alpha(a-z)
tax Numeric 10,3 Numeric (0-9)
XRateUSD2Payout varchar 15 Numeric (0-9)
agentRatePayinToPayout Numeric 15,8 Numeric (0-9)
commissionInSettlementCcy Numeric 10,3 Numeric (0-9)
otherChargesInSettlementCcy Numeric 10,3 Numeric (0-9)
commission Numeric 10,3 Numeric (0-9)
taxInSettlementCcy Numeric 10,3 Numeric (0-9)
xpin char 16 Numeric (0-9)
payinAmount Numeric 15,3 Numeric (0-9)
payoutAmount Numeric 15,3 Numeric (0-9)
totalPayinAmount Numeric 15,3 Numeric (0-9)
totalDiscount int Numeric (0-9)
NetPayinAmount Numeric 15,3 Numeric (0-9)
1.2 EditXMTransaction Method
a. You can Edit a transaction using EditXMTransaction method for the transactions created using
CreateXMTransaction and yet to be confirmed. Using this method, you can edit 5 different types of
transactions which are Cash to Cash, Account Credit, Door Delivery, Cash to Card and Cash to Mobile.
b. To edit a transaction, this method requires Xpin (CreateXMTransaction), authentication details, sender –
receiver details, and transaction details.
c. Once you get a success response from EditXMTransaction, you should immediately
ConfirmXMTransaction to confirm the transaction in XM System.

authenticationAgentCode char 12 AlphaNumeric (a-z, 0-9)
userID char 16 AlphaNumeric (a-z, 0-9)
Password char 30 AlphaNumeric (a-z, 0-9)
Pin char 10 AlphaNumeric (a-z, 0-9)
11
www.xpressmoney.com
agentTxnRefNo char 20 AlphaNumeric (a-z, 0-9)
customerLastName char 60 Alpha(a-z)
customerPOBox char 60 Numeric (0-9)
customerAddress1 char 60 AlphaNumeric (a-z, 0-9) SpecialChar
customerAddressCity char 60 Alpha(a-z)
customerAddressCountryCode char 2 Alpha(a-z)
customerAddressZip char 10 AlphaNumeric (a-z, 0-9)
customerPrimaryContactCountryCode char 6 Numeric (0-9)
customerPrimaryContactNoType int Numeric (0-9)
customerSecContactCountryCode char 6 Numeric (0-9)
CustomerSmsNotify int Numeric (0-9)
customerOtherInfo char 40 AlphaNumeric (a-z, 0-9) SpecialChar
customerDescription char 60 AlphaNumeric (a-z, 0-9) SpecialChar
customerEmail char 40 AlphaNumeric (a-z, 0-9) SpecialChar
customerNationalityCode char 2 Alpha(a-z)
customerIDOtherType char 20 AlphaNumeric (a-z, 0-9)
customerID char 25 AlphaNumeric (a-z, 0-9)
customerIDIssuedBy char 60 AlphaNumeric (a-z, 0-9)
customerIDIssuedAt char 50 AlphaNumeric (a-z, 0-9)
customerIDIssuanceCountry char 2 Alpha(a-z)
customerProofOfAddress char 3 AlphaNumeric (a-z, 0-9)
customerSecondaryIDType int Numeric (0-9)
customerSecondaryIDNo char 20 AlphaNumeric (a-z, 0-9)
customerSecondaryIDIssuedBy char 60 AlphaNumeric (a-z, 0-9)
customerSecondaryIDIssuedAt char 60 AlphaNumeric (a-z, 0-9)
customerSecIDIssuanceCountry char 2 Alpha(a-z)
12
www.xpressmoney.com
customerSecondaryIDIssueDate datetime Numeric (0-9) -
customerSecondaryIDValidThru datetime Numeric (0-9) -
customerPlaceOfBirth char 60 Alpha(a-z)
customerOccupation char 40 AlphaNumeric (a-z, 0-9)
customerGender char 1 Alpha(a-z)
customerEmployerName char 60 Alpha(a-z)
customerEmployerPhoneCountryCode char 6 Numeric (0-9)
customerEmployerPhone char 40 Numeric (0-9)
beneficiaryIDOtherType char 20 AlphaNumeric (a-z, 0-9)
beneficiaryID char 60 AlphaNumeric (a-z, 0-9)
beneficiaryAddress1 char 60 AlphaNumeric (a-z, 0-9) SpecialChar
beneficiaryAddressZip char 60 Numeric (0-9)
beneficiaryPhoneCountryCode char 6 Numeric (0-9)
beneficiaryNationalityCode char 2 Alpha(a-z)
beneficiaryTestQuestion char 100 AlphaNumeric (a-z, 0-9) SpecialChar
beneficiaryTestAnswer char 40 AlphaNumeric (a-z, 0-9) SpecialChar
messageToBeneficiary char 100 AlphaNumeric (a-z, 0-9) SpecialChar
beneficiaryRelationship char 60 Alpha(a-z)
xmCustomerNo char 16 Numeric (0-9)
xmLoyaltyNo char 12 Numeric (0-9)
promoCode char 16 AlphaNumeric (a-z, 0-9) SpecialChar
sendingAgentCode char 12 AlphaNumeric (a-z, 0-9)
receivingAgentCode char 12 AlphaNumeric (a-z, 0-9)
sendingAmountFlag char 6 AlphaNumeric (a-z, 0-9)
paymentMode char 2 AlphaNumeric (a-z, 0-9)
13
www.xpressmoney.com
authorizationCode char 20 AlphaNumeric (a-z, 0-9)
accountName char 120 Alpha(a-z)
accountNo char 60 Numeric (0-9)
accountIBAN char 100 AlphaNumeric (a-z, 0-9)
beneficiarySmsNotify int Numeric (0-9)
bankName char 100 Alpha(a-z)
bankCode char 12 Numeric (0-9)
bankBranchName char 100 Alpha(a-z)
mobileWalletCountryCode char 6 Numeric (0-9)
mobileWalletNo char 16 Numeric (0-9)
cardNumber char 20 Numeric (0-9)
cardType int Numeric (0-9)
mobileOrCardAddInfo1 char 60 AlphaNumeric (a-z, 0-9) SpecialChar
mobileOrCardAddInfo2 char 60 AlphaNumeric (a-z, 0-9) SpecialChar
Response Field Description:

returnCode
returnMsg
14
www.xpressmoney.com
1.3 ConfirmXMTransaction Method
a. Once the Method ConfirmXMtransaction is called, transaction will be successfully created in XM

system and will be ready for payout.
b. This method requires XPIN and authentication details to be passed to confirm a transaction. A transaction
must be confirmed within 24 hours from the creation of the transaction using CreateXMTransaction
method.

password char 30 AlphaNumeric (a-z, 0-9)
pin char 10 AlphaNumeric (a-z, 0-9)

returnCode
returnMsg
15
www.xpressmoney.com
2. Receive Remittance Methods
2.1 getAllOutstandingTransactions Method

a. You can use this method to generate a list of all outstanding transactions sent to your agent locations.
b. This method can only be used for receiving Account Credit, Cash to Mobile and Cash to Card & Door
Delivery transactions. You can’t get a list of Cash to Cash outstanding transactions using this method.
c. To generate the list, this method will require authentication details, receiving agent code and delivery
option for which the list needs to be generated.

deliveryOption ( AC, MW, EC, DS) char 2 AlphaNumeric (a-z, 0-9)
AC – Account Credit
MW – Cash to Mobile
EC – Cash to Card (E-Card)
DS – Door Delivery
Response Field Description

xmwsSessionID char 20 AlphaNumeric (a-z, 0-9)
payoutDate char 11 AlphaNumeric (a-z, 0-9), SpecialChar
payinCcyCode char 3 AlphaNumeric (a-z, 0-9), SpecialChar
payinDate char 11 AlphaNumeric (a-z, 0-9), SpecialChar
accountName varchar 183 AlphaNumeric (a-z, 0-9), SpecialChar
accountNo char 60 AlphaNumeric (a-z, 0-9), SpecialChar
bankName char 100 AlphaNumeric (a-z, 0-9), SpecialChar
16
www.xpressmoney.com
bankBranchName char 100 AlphaNumeric (a-z, 0-9), SpecialChar
xmBankAdditionalInfo1
xmBankAdditionalInfo2
beneficiaryMobileCountryCode varchar 20 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryMobileNumber varchar 20 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryMobileISOCountryCode char 2 AlphaNumeric (a-z, 0-9), SpecialChar
xmMWAdditionalInfo1
xmMWAdditionalInfo2
beneficiaryCardNumber char 20 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryCardType int Numeric (0-9)
xmECAdditionalInfo1
xmECAdditionalInfo2
2.2 updateAllOutstandingtxnlist Method

a. This is an optional method to be used by agents to block/release transactions.
b. This is mostly used for Door Delivery and Account Credit transactions where the receiving agent can
acknowledge that the transaction is under processing (in transit) and once paid (credited into beneficiary
account) can later confirm the payment using confirmAllOutstandingReceiveTxn method.
c. In case the transaction is not processed due to any reason, the agent can release the transaction using
this method so that it can be cancelled.
d. This method can only be used for Account Credit, Cash to Mobile and Cash to Card & Door
Delivery transactions.
e. To generate the list, this method will require authentication details, receiving agent code and delivery
option for which the list needs to be generated.

checkStatus int 1 Numeric (0-9) (1=block, 4=release)
reasonMessage char 60 AlphaNumeric (a-z, 0-9) SpecialChar

xpin char 16 AlphaNumeric (a-z, 0-9)
returnMsg char 250 AlphaNumeric (a-z, 0-9)
17
www.xpressmoney.com
returnCode int Numeric (0-9)
2.3 confirmAllOutstandingReceiveTxn Method

a. You can use this method to confirm (mark as Paid) any outstanding transaction sent to your agent
location.
b. This method can only be used for receiving Account Credit, Cash to Mobile and Cash to Card &
Door Delivery transactions.
c. It will require authentication details, receiving agent code and delivery option for which the list needs to be
generated.
d. Receiver ID related fields are optional.

beneficiaryIDIssuedBy char 60 AlphaNumeric (a-z, 0-9)
beneficiaryIDIssuedAt char 60 AlphaNumeric (a-z, 0-9)
beneficiaryIDIssueDate datetime
beneficiaryIDValidThru datetime
beneficiaryDateOfBirth datetime
beneficiaryNationalityCode char 2 AlphaNumeric (a-z, 0-9)
deliverydate datetime
messageFromBeneficiary char 250 AlphaNumeric (a-z, 0-9), SpecialChar
letterFromBeneficiary int AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryOccupation char 40 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryEmployerName char 60 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryEmployerPhoneCountryCode char 2 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryEmployerPhone char 40 AlphaNumeric (a-z, 0-9), SpecialChar
purposeOfTxn char 40 AlphaNumeric (a-z, 0-9), SpecialChar
18
www.xpressmoney.com
xpin char 16 AlphaNumeric (a-z, 0-9)
2.4 getXMReceiveTxn Method

a. You can use this method to fetch the details of a transaction sent to your location using the XPIN
(Transaction Reference Number) shared by the Receiver.
b. This is mainly used for receiving Cash to Cash transactions.
c. You need to pass Authentication details, receiving agent code and XPIN in the request.
d. The response will return the complete information about the transaction.

sessionDate char 16 AlphaNumeric (a-z, 0-9)

customerFirstName char 60 AlphaNumeric (a-z, 0-9) SpecialChar
customerMiddleName char 60 AlphaNumeric (a-z, 0-9) SpecialChar
customerLastName char 60 AlphaNumeric (a-z, 0-9) SpecialChar
customerPOBox char 10 AlphaNumeric (a-z, 0-9) SpecialChar
customerAddressCity char 60 AlphaNumeric (a-z, 0-9) SpecialChar
customerAddressState char 60 AlphaNumeric (a-z, 0-9) SpecialChar
customerAddressCountry char 2 AlphaNumeric (a-z, 0-9) SpecialChar
customerAddressZip char 25 AlphaNumeric (a-z, 0-9) SpecialChar
customerPhone char 40 AlphaNumeric (a-z, 0-9) SpecialChar
customerMobile char 20 AlphaNumeric (a-z, 0-9) SpecialChar
customerFax char 40 AlphaNumeric (a-z, 0-9) SpecialChar
customerEmail char 60 AlphaNumeric (a-z, 0-9) SpecialChar
19
www.xpressmoney.com
customerDescription char 60 AlphaNumeric (a-z, 0-9) SpecialChar
customerOtherInfo char 60 AlphaNumeric (a-z, 0-9) SpecialChar
beneficiaryFirstName char 60 AlphaNumeric (a-z, 0-9) SpecialChar
beneficiaryMiddleName char 60 AlphaNumeric (a-z, 0-9) SpecialChar
beneficiaryLastName char 60 AlphaNumeric (a-z, 0-9) SpecialChar
beneficiaryAddressCity char 60 AlphaNumeric (a-z, 0-9) SpecialChar
beneficiaryAddressState char 60 AlphaNumeric (a-z, 0-9) SpecialChar
beneficiaryAddressCountry char 2 AlphaNumeric (a-z, 0-9) SpecialChar
beneficiaryAddressZip char 25 AlphaNumeric (a-z, 0-9) SpecialChar
beneficiaryPhone char 40 AlphaNumeric (a-z, 0-9) SpecialChar
beneficiaryMobile char 20 AlphaNumeric (a-z, 0-9) SpecialChar
beneficiaryFax char 40 AlphaNumeric (a-z, 0-9) SpecialChar
beneficiaryEmail char 60 AlphaNumeric (a-z, 0-9) SpecialChar
beneficiaryTestQuestion char 60 AlphaNumeric (a-z, 0-9) SpecialChar
beneficiaryTestAnswer char 40 AlphaNumeric (a-z, 0-9) SpecialChar
messageToBeneficiary char 250 AlphaNumeric (a-z, 0-9) SpecialChar
beneficiaryDescription char 250 AlphaNumeric (a-z, 0-9) SpecialChar
beneficiaryOtherInfo char 60 AlphaNumeric (a-z, 0-9) SpecialChar
purposeOfTxn char 60 AlphaNumeric (a-z, 0-9) SpecialChar
sourceOfIncome char 60 AlphaNumeric (a-z, 0-9) SpecialChar
payInAmount Numeric 15,3 Numeric (0-9)
agentXchgRate Numeric 15,8 Numeric (0-9)
payoutCcyCode char 3 AlphaNumeric (a-z, 0-9) SpecialChar
payInCcyCode char 3 AlphaNumeric (a-z, 0-9) SpecialChar
payoutDate datetime
payinDate datetime
sendingAgentCode char 12 AlphaNumeric (a-z, 0-9) SpecialChar
sendingAgentName char 100 AlphaNumeric (a-z, 0-9) SpecialChar
receivingAgentCode char 12 AlphaNumeric (a-z, 0-9) SpecialChar
receivingAgentName char 100 AlphaNumeric (a-z, 0-9) SpecialChar
sendingCountry char 60 AlphaNumeric (a-z, 0-9) SpecialChar
receiveCountry char 60 AlphaNumeric (a-z, 0-9) SpecialChar
20
www.xpressmoney.com
transactionMode char 12 AlphaNumeric (a-z, 0-9) SpecialChar
2.5 confirmXMReceiveTxn Method

a. You can use this method to confirm (mark as Paid) the transaction whose information is fetched
using getXMReceiveTxn method.
b. It will require authentication details, session ID, XPIN, beneficiary ID details and nationality to be
passed in request.

beneficiaryIDIssuedBy char 60 AlphaNumeric (a-z, 0-9)
beneficiaryIDIssuedAt char 60 AlphaNumeric (a-z, 0-9)
beneficiaryIDIssueDate datetime
beneficiaryIDValidThru datetime
beneficiaryDateOfBirth datetime
beneficiaryNationalityCode char 2 AlphaNumeric (a-z, 0-9), SpecialChar
purposeOfTxn char 40
xmReserved1 char 2 Alpha(a-z)
xmReserved2 char 60 AlphaNumeric (a-z, 0-9)
xmReserved3 char 3 Alpha(a-z)
xmReserved4 char 250 AlphaNumeric (a-z, 0-9)

XPIN char 16 AlphaNumeric (a-z, 0-9)
3. Cancel Remittance Methods
3.1 getXMSCancelTxn Method
21
www.xpressmoney.com
a. You can cancel a transaction by calling the getXMSCancelTxn method.

b. This method requires the authentication details, sending Agent code and XPIN details to be passed.
c. In response, it will return the session ID and the transaction will be ready for cancellation.
d. It will also return transaction details and the amount to be settled to the customer.
e. Following this, confirmXMSCancelTxn method must be called to confirm the cancellation from XM
system.
agentTxnRefNo char 20 AlphaNumeric (a-z, 0-9)
cancellationReason char 1 AlphaNumeric (a-z, 0-9), SpecialChar
cancellationReasonDescription char 40 AlphaNumeric (a-z, 0-9), SpecialChar

returnMsg char 250 AlphaNumeric (a-z, 0-9), SpecialChar
xmwsSessionID char 16 AlphaNumeric (a-z, 0-9), SpecialChar
agentTxnRefNo char 20 AlphaNumeric (a-z, 0-9), SpecialChar
xpin char 16 AlphaNumeric (a-z, 0-9), SpecialChar
sendingAgentName char 100 AlphaNumeric (a-z, 0-9), SpecialChar
receivingAgentName char 100 AlphaNumeric (a-z, 0-9), SpecialChar
sendingAgentCode char 12 AlphaNumeric (a-z, 0-9), SpecialChar
receivingAgentCode char 12 AlphaNumeric (a-z, 0-9), SpecialChar
deliveryOption char 2 AlphaNumeric (a-z, 0-9), SpecialChar
deliveryOptionName char 20 AlphaNumeric (a-z, 0-9), SpecialChar
payinCcyCode char 3 AlphaNumeric (a-z, 0-9), SpecialChar
payoutCcyCode char 3 AlphaNumeric (a-z, 0-9), SpecialChar
refundPayinAmount Numeric 15,3 Numeric (0-9)
refundCommission Numeric 10,3 Numeric (0-9)
refundTax Numeric 10,3 Numeric (0-9)
refundOtherCharges Numeric 10,3 Numeric (0-9)
cancellationCharges Numeric 10,3 Numeric (0-9)
totalRefundPayinAmount Numeric 15,3 Numeric (0-9)
customerFirstName char 60 AlphaNumeric (a-z, 0-9), SpecialChar
22
www.xpressmoney.com
customerMiddleName char 60 AlphaNumeric (a-z, 0-9), SpecialChar
customerLastName char 60 AlphaNumeric (a-z, 0-9), SpecialChar
customerPOBox char 10 AlphaNumeric (a-z, 0-9), SpecialChar
customerAddress1 char 60 AlphaNumeric (a-z, 0-9), SpecialChar
customerAddressCity char 60 AlphaNumeric (a-z, 0-9), SpecialChar
customerAddressState char 60 AlphaNumeric (a-z, 0-9), SpecialChar
customerAddressCountryCode char 2 AlphaNumeric (a-z, 0-9), SpecialChar
customerAddressZip char 25 AlphaNumeric (a-z, 0-9), SpecialChar
customerPhone char 40 AlphaNumeric (a-z, 0-9), SpecialChar
customerMobile char 20 AlphaNumeric (a-z, 0-9), SpecialChar
customerFax char 40 AlphaNumeric (a-z, 0-9), SpecialChar
customerEmail char 60 AlphaNumeric (a-z, 0-9), SpecialChar
sourceOfIncome char 3 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryFirstName char 60 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryMiddleName char 60 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryLastName char 60 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryPOBox char 10 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryAddress1 char 60 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryAddressCity char 60 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryAddressState char 60 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryAddressCountryCode char 2 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryAddressZip char 25 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryPhone char 40 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryMobile char 20 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryFax char 40 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryEmail char 60 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryTestQuestion char 60 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryTestAnswer char 40 AlphaNumeric (a-z, 0-9), SpecialChar
messageToBeneficiary char 250 AlphaNumeric (a-z, 0-9), SpecialChar
3.2 ConfirmXMSCancelTxn Method:

a. For Confirming the Cancellation you must call the method confirmXMSCancelTxn by providing the
session ID and XPIN details.
b. Once this method is successful, money can be refunded to the customer.
23
www.xpressmoney.com

4. Utility Methods
4.1 getXMRateCalculateDetails Method:

a. This method is used to calculate the rates with send and receive currency for a proposed transaction.
This method will give clear information on the sender’s payin and payout amount for a particular
transaction.
b. This method will need authentication details and transaction details which will return information about the
exchange rate applied on the proposed transaction.

authenticationAgentCode char 12 AlphaNumeric (a-z, 0-9), SpecialChar
userID char 16 AlphaNumeric (a-z, 0-9), SpecialChar
password char 30 AlphaNumeric (a-z, 0-9), SpecialChar
pin char 10 AlphaNumeric (a-z, 0-9), SpecialChar
amountType char 12 Alpha (a-z)
deliveryOption char 2 AlphaNumeric (a-z, 0-9)
fromCcy char 3 Alpha (a-z)
fromCountry char 2 AlphaNumeric (a-z, 0-9), SpecialChar
toCcy char 3 Alpha (a-z)
toCountry char 2 AlphaNumeric (a-z, 0-9), SpecialChar
includeCharges char 1 Alpha (a-z)
paymentMode char 2 AlphaNumeric (a-z, 0-9)
transactionSource int Numeric (0-9)
24
www.xpressmoney.com
serviceProvider char 12 AlphaNumeric (a-z, 0-9)

payinCcy char 3 AlphaNumeric (a-z, 0-9), SpecialChar
payoutCcy char 3 AlphaNumeric (a-z, 0-9), SpecialChar
commissionCharges Numeric 15,3 Numeric (0-9)
commissionCcy char 3 Numeric (0-9)
xchangeRate Numeric 15,8 Numeric (0-9)
discount Numeric 15,3 Numeric (0-9)
settlementRate Numeric 15,8 Numeric (0-9)
4.2 getXMAgentDetails Method

a. You can use the method getXMAgentDetails method to search and generate the list of send
or receive agents in a particular country.
b. This method requires authentication details, city/ zip code/ country code and Service Type to be
passed in the request.

countryCode char 12 Alpha (a-z)
city char 60 AlphaNumeric (a-z, 0-9), SpecialChar
serviceType ( SD / RV) char 16 Alpha (a-z)
zipCode char 25 Numeric (0-9)
25
www.xpressmoney.com
agentCode char 12 AlphaNumeric (a-z, 0-9), SpecialChar
agentBranch char 60 AlphaNumeric (a-z, 0-9), SpecialChar
agentName char 100 AlphaNumeric (a-z, 0-9), SpecialChar
address varchar 121 AlphaNumeric (a-z, 0-9), SpecialChar
cityOrDistrict varchar 122 AlphaNumeric (a-z, 0-9), SpecialChar
state varchar 60 AlphaNumeric (a-z, 0-9), SpecialChar
countryCode char 2 AlphaNumeric (a-z, 0-9), SpecialChar
phone char 40 AlphaNumeric (a-z, 0-9), SpecialChar
hoursOfOpertation char 60 AlphaNumeric (a-z, 0-9), SpecialChar
agentHolidays char 60 AlphaNumeric (a-z, 0-9), SpecialChar
services varchar 14 AlphaNumeric (a-z, 0-9), SpecialChar
4.3 getXMCountryDetails Method

a. This is a utility method which can be used to get information about the supported currencies and ID types
in a country, whether the country is Send only or Receive only or both, whether Anywhere payout option
is available and which service types are enabled in the country.
b. This method requires authentication details and country code to get the mentioned details about
the country.
What is meant by the term – “Anywhere Payout”?
There are several countries in Xpress Money network where the sender doesn’t need to specify a
receive location while sending a transaction. These countries are termed as “Anywhere Payout”
countries in Xpress Money network.

pin char 10 Numeric (0-9)

26
www.xpressmoney.com
countryCode char 2 AlphaNumeric (a-z, 0-9), SpecialChar
countryName char 100 AlphaNumeric (a-z, 0-9), SpecialChar
countryActivity char 16 AlphaNumeric (a-z, 0-9), SpecialChar
isAnyWherePayoutCountry char 1 AlphaNumeric (a-z, 0-9), SpecialChar
anyWherePayoutCountryCode char 12 AlphaNumeric (a-z, 0-9), SpecialChar
serviceTypeBit int Numeric (0-9)
payinAmountLimit Numeric 15,3 Numeric (0-9)
payoutAmountLimit Numeric 15,3 Numeric (0-9)
purposeCode char 3 AlphaNumeric (a-z, 0-9), SpecialChar
purposeDescription char 60 AlphaNumeric (a-z, 0-9), SpecialChar
sourceOfIncomeCode char 3 AlphaNumeric (a-z, 0-9), SpecialChar
sourceOfIncomeDescription char 60 AlphaNumeric (a-z, 0-9), SpecialChar
IDIndexNo int Numeric (0-9)
IDType char 60 AlphaNumeric (a-z, 0-9), SpecialChar
issueDateStatus int Numeric (0-9)
4.4 getXMBankDetails Method

a. This is a utility method used to get the details of the banks associated with XM system in a particular
country which will be used to create Account credit transaction in XM system.
b. This method requires authentication details and country code to fetch the bank information which will
be used while calling CreateXMTransaction method.


bankCode int Numeric (0-9)
agentCode char 12 AlphaNumeric (a-z, 0-9), SpecialChar
bankName char 60 AlphaNumeric (a-z, 0-9), SpecialChar
countryName char 100 AlphaNumeric (a-z, 0-9), SpecialChar
27
www.xpressmoney.com
bankAdditionalInfo1
bankAdditionalInfo2
4.5 GetXMXpinEnquiry Method

a. This method is used to enquire about the details of a transaction such as Sender &
Receiver information, Transaction Amount etc.
b. The input parameters are XPIN along with authentication details. This method returns all
the transaction details provided during CreateXMTransaction/EditXMTransaction method.

agentCode char 12 AlphaNumeric (a-z, 0-9)

customerFirstName char 60 AlphaNumeric (a-z, 0-9), SpecialChar
customerMiddleName char 60 AlphaNumeric (a-z, 0-9), SpecialChar
customerLastName char 60 AlphaNumeric (a-z, 0-9), SpecialChar
customerPOBox char 10 AlphaNumeric (a-z, 0-9), SpecialChar
customerAddressCity char 60 AlphaNumeric (a-z, 0-9), SpecialChar
customerAddressState char 60 AlphaNumeric (a-z, 0-9), SpecialChar
customerAddressCountry char 100 AlphaNumeric (a-z, 0-9), SpecialChar
customerAddressZip char 25 AlphaNumeric (a-z, 0-9), SpecialChar
customerSecondaryContactNumber char 40 AlphaNumeric (a-z, 0-9), SpecialChar
customerPrimaryContactNumber char 20 AlphaNumeric (a-z, 0-9), SpecialChar
customerFax char 40 AlphaNumeric (a-z, 0-9), SpecialChar
customerEmail char 40 AlphaNumeric (a-z, 0-9), SpecialChar
customerDescription char 60 AlphaNumeric (a-z, 0-9), SpecialChar
customerOtherInfo char 60 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryFirstName char 60 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryMiddleName char 60 AlphaNumeric (a-z, 0-9), SpecialChar
28
www.xpressmoney.com
beneficiaryLastName char 60 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryIDOtherType char 15 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryID char 25 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryPOBox char 40 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryAddressCity char 60 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryAddressState char 60 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryAddressCountry char 100 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryAddressZip char 25 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryPhone char 40 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryMobile char 20 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryFax char 40 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryEmail char 40 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryTestQuestion char 60 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryTestAnswer char 40 AlphaNumeric (a-z, 0-9), SpecialChar
messageToBeneficiary char 250 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryDescription char 250 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryOtherInfo char 60 AlphaNumeric (a-z, 0-9), SpecialChar
sourceOfIncome char 60 AlphaNumeric (a-z, 0-9), SpecialChar
sendingAgentCode char 12 AlphaNumeric (a-z, 0-9), SpecialChar
sendingAgentName char 100 AlphaNumeric (a-z, 0-9), SpecialChar
receivingAgentCode char 2 AlphaNumeric (a-z, 0-9), SpecialChar
receivingAgentName char 100 AlphaNumeric (a-z, 0-9), SpecialChar
4.6 GetXMXpinStatus Method:

a. This method is used to check the status of a transaction.
b. This method returns the transaction Status whether it is Active, Cancelled or Paid.
c. Authentication details and XPIN need to be passed in the request.

29
www.xpressmoney.com

5. Amendment Methods
5.1 getXMTxnAmendment Method
The Name Amendment process will enable a user to amend the transaction details of an
XPIN after the same has been generated and is Active in the system. This method used to
get the provided XPIN's customer details, beneficiary details. This method will provide
those details only when the transaction applicable to process amendment. This method
requires authentication details and XPIN to give the transaction details.

returnCode int 4 Numeric (0-9)
returnMsg char 250 Alpha Numeric (a-z, 0-9)
customerLastName char 60 Alpha (a-z)
customerAddress1 char 60 Alpha Numeric (a-z, 0-9), Special Char
customerAddress2 char 60 Alpha Numeric (a-z, 0-9), Special Char
customerAddressCity char 60 Alpha (a-z)

30
www.xpressmoney.com
customerSecContactCountry char 6 Numeric (0-9)
Code
customerSecContactCountry char 6 Numeric (0-9)
Code
beneficiaryAddress2 char 60 Alpha Numeric (a-z, 0-9), Special Char
beneficiaryPhoneCountry 6 Numeric (0-9)
char
Code
5.2 confirmXMTxnAmendment Method:

Amendment details can be edited only based on Amendment Type provided. For Ex:
1 If the AmendmentType is provided as S, then the customer details and Customer ID details
must be provided and Beneficiary details must be empty, such that customer details will be
amended.
2 If the AmendmentType is provided as R, then the beneficiary details and Customer ID details
must be provided and Customer details must be empty, such that beneficiary details will be
amended.
3 If the AmendmentType is provided as B, then the customer details, beneficiary details and
Customer ID details must be provided, such that customer & beneficiary details will be
amended in Xpress Money System.


31
www.xpressmoney.com
char 2 Alpha(a-z)
customerUpdatedFirstName char 60 Alpha(a-z)
customerUpdatedMiddleName int Alpha(a-z)
customerUpdatedLastName char 60 Alpha(a-z)
customerUpdatedAddress1 char 60 AlphaNumeric (a-z, 0-9), SpecialChar
customerUpdatedAddress2 char 60 AlphaNumeric (a-z, 0-9), SpecialChar
customerUpdatedAddressCity char 60 Alpha(a-z)
customerUpdatedAddressState char 60 Alpha(a-z)
customerUpdatedPrimaryContactCount char 6 Numeric (0-9)
ryCode
customerUpdatedPrimaryContactNo char 20 Numeric (0-9)
customerUpdatedSecContactCountryC char 6 Numeric (0-9)
ode
customerUpdatedSecContactNo char 40 Numeric (0-9)
beneficiaryUpdatedFirstName char 60 Alpha(a-z)
beneficiaryUpdatedMiddleName char 60 Alpha(a-z)
beneficiaryUpdatedLastName char 60 Alpha(a-z)
beneficiaryUpdatedAddress1 char 60 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryUpdatedAddress2 char 60 AlphaNumeric (a-z, 0-9), SpecialChar
beneficiaryUpdatedAddressCity char 60 Alpha(a-z)
beneficiaryUpdatedAddressState char 60 Alpha(a-z)
beneficiaryUpdatedAddressCountry char 2 Alpha(a-z)
Code
beneficiaryUpdatedPhoneCountryCode char 6 Numeric (0-9)

beneficiaryUpdatedPhone char 40 Alpha(a-z)
beneficiaryUpdatedMobileCountryCode char 6 Numeric (0-9)
beneficiaryUpdatedMobile char 20 Numeric (0-9)
customerIDOtherType char 20 Alpha Numeric (a-z, 0-9)
customerID char 25 Alpha Numeric (a-z, 0-9)
customerIDIssuedBy char 60 Alpha Numeric (a-z, 0-9)
customerIDIssuedAt char 50 Alpha Numeric (a-z, 0-9)
amendmentReason char 180 AlphaNumeric (a-z, 0-9), SpecialChar
amendmentOtherReason char 180 AlphaNumeric (a-z, 0-9), SpecialChar
32
www.xpressmoney.com

returnCode int 4 Numeric (0-9)
6. Glossary
6.1 Status Codes
Status Transaction status Description Possible actions

Code
100 Invalid Xpin Invalid Xpin Re-check the Xpin
5001 Xpin does not exists!
100 TxnStatus not available at this

time, try again later ..!
100 Pending for Processed - Pending for Transaction not yet confirmed
Authorization Authorization at Send Agent
100 Available for payout Sent - Ready for pickup at Ready for Cancellation, Ready
destination for Payout
100 Paid Completed - Credited to Transaction Completed its
beneficiary's account workflow. No Actions Further
100 Completed - Received by Ready for Paid Cancellation (if
beneficiary required)
100 Cancelled Completed - Cancelled by Transaction Completed its
Sender/Agent workflow. No Actions Further
100 Paid Cancellation Cancelled Paid Transaction Transaction Completed its
workflow. No Actions Further
100 Suspended Quarantined - Pickup time Contact XM support
expired xmsupport@xpressmoney.com
100 Suspended Transaction is under
verification
33
www.xpressmoney.com
100 Hold
100 Release for both Released - Ready for Pick up Transaction available at
cancellation and destination for payout.
Payment
100 Release for Released - Available for Transaction available for
Cancellation cancellation only cancellation
100 Transmitted Transmitted - Available at Transaction available at
Destination destination for payout.
100 Revoke transmission Revoked - Transmission has Available for Re-Transmission
been revoked / Send -now Cancellation
100 Rejected Denied - Transmission has Transaction available for
been rejected cancellation
100 Remittance Reserve Suspended - Remittance Transaction cannot be pulled
Reserve out
6.2 Error Codes:
ErrorCode ErrorMessage
100 Success
2000 Enter Agent Txn Ref No
2001 Special Characters are not allowed in AgentTxnRefNo
2002 Agent Txn Ref No should not exceed 20 characters
2003 Enter Delivery Option
2004 Invalid delivery option. Following are the valid delivery options:- PS, AC, DS, EC, MW
2005 This Delivery Option is not applicable for this country
2006 Enter Customer First Name
2007 Special characters and numbers are not allowed in Customer First Name.
2008 Special characters and numbers are not allowed in Customer Middle Name.
2009 Enter Customer Last Name
2010 Special characters and numbers are not allowed in Customer Last Name.
2011 Customer Post Box accepts numbers only
2012 Enter CustomerAddress1
2013 Enter Customer Address City
2014 Special characters and numbers are not allowed in Customer Address City
2015 Special characters and numbers are not allowed in Customer Address State
2016 Enter Customer Address Country Code
2017 Invalid Customer Address Country Code
2018 CustomerAddressZip accepts numbers only
2019 Enter Customer Primary Contact Country Code
2020 Invalid Customer Primary Contact Country Code
2021 Customer Primary Contact Country Code accepts numbers only
2022 Enter Customer Primary Contact No
2023 Invalid Customer Primary Contact No
2024 Customer Primary Contact No accepts numbers only
34
www.xpressmoney.com
2025 Enter Customer Primary Contact No Type
2026 Invalid Customer Primary Contact No Type, Should be either 1, 2, or 3
2027 Customer Primary Contact No Type accepts numbers only
2028 Enter Customer Secondary Contact Country Code
2029 Invalid Customer Secondary Contact Country Code
2030 Customer Secondary Contact Country Code accepts numbers only
2031 Enter Customer Secondary Contact No
2032 Invalid Customer Secondary Contact No
2033 Customer Secondary Contact No accepts numbers only
2034 Enter Customer Secondary Contact No Type
2035 Invalid Customer Secondary Contact No Type, Should be either 1, 2, or 3
2036 Customer Secondary Contact No Type accepts numbers only
2037 Enter Either Customer Primary Contact or Customer Secondary Contact
2038 Invalid Customer SMS Notify, Should be either 1 or 2
2039 Customer Email id should not exceed 40 characters
2040 Invalid Customer Email id(s)
2041 Enter Customer Nationality Code
2042 Invalid Customer Nationality Code
2043 Enter Source Of Income
2044 Invalid Source Of Income
2045 Enter Purpose Of Txn
2046 Invalid Purpose Of Txn
2047 Customer ID Type accepts numbers only
2048 Special Characters are not allowed in Customer ID Other Type
2049 CustomerIDOtherType is required
2050 Special Characters are not allowed in Customer ID
2051 Special Characters are not allowed in Customer ID IssuedBy
2052 Special Charactersare not allowed in Customer ID IssuedAt
2053 Special Characters are not allowed in Customer ID Issuance Country
2054 Special Characters are not allowed in Customer Proof Of Address
2055 Customer Secondary ID Type accepts numbers only
2056 Special Characters are not allowed in Customer Secondary ID No
2057 Special Characters are not allowed in Customer Secondary ID IssuedBy
2058 Special Characters are not allowed in Customer Secondary ID IssuedAt
2059 Special Characters are not allowed in Customer Secondary ID Issuance Country
2060 Special Characters are not allowed in Customer Occupation
2061 Invalid Customer Gender, Should be M or F
2062 Special characters and numbers are not allowed in Customer Employer Name
2063 Enter Customer Employer Phone Country Code
2064 Customer Employer Phone Country Code accepts numbers only
2065 Customer Employer Phone accepts numbers only
2066 Enter Customer Employer Phone
2067 Enter Beneficiary First Name
2068 Special characters and numbers are not allowed in Beneficiary First Name
2069 Special characters and numbers are not allowed in Beneficiary Middle Name
2070 Enter Beneficiary Last Name
2071 Special characters and numbers are not allowed in Beneficiary Last Name
35
www.xpressmoney.com
2072 Enter Beneficiary ID Other Type
2073 Special Characters are not allowed in Beneficiary ID Other Type
2074 Beneficiary ID Type accepts numbers only
2075 Special Characters are not allowed in Beneficiary ID
2076 Beneficiary Post Box accepts numbers only
2077 Special characters and numbers are not allowed in Beneficiary Address City
2078 Special characters and numbers are not allowed in Beneficiary Address State
2079 Enter Beneficiary Address Country Code
2080 Invalid Beneficiary Address Country Code for given receiving Agent
2081 Beneficiary Address Zip accepts numbers only
2082 Invalid Beneficiary Phone Country Code
2083 Enter Beneficiary Phone Country Code
2084 Beneficiary Phone Country Code accepts numbers only
2085 Beneficiary Phone accepts numbers only
2086 Enter Beneficiary Phone
2087 Enter Beneficiary Mobile Country Code
2088 Enter Either Beneficiary Phone or Beneficiary Mobile
2089 Beneficiary Mobile Country Code accepts numbers only
2090 Invalid Beneficiary Mobile Country Code
2091 Beneficiary Mobile accepts numbers only
2092 Enter Beneficiary Mobile
2093 Enter Beneficiary Nationality Code
2094 Invalid Beneficiary Nationality Code
2095 Enter Beneficiary Test Question
2096 Enter Beneficiary Test Answer
2097 Special Characters are not allowed in Beneficiary Relationship
2098 XM Customer No accepts numbers only
2099 Enter XM Customer No or Loyalty No for proceed the transaction
2100 XM Loyalty No accepts numbers only
2101 Enter Sending Agent Code
2102 Invalid Sending Agent Code
2103 Special Characters are not allowed in Sending Agent Code
2104 Enter Receiving Agent Code
2105 Invalid Receiving Agent Code
2106 Transaction is not allowed to the Receiving Agent Code
2107 Receive Agent is Inactive
2108 Invalid Beneficiary Address Country Code for given Receiving Agent Code
2109 Special Characters are not allowed in Receiving Agent Code
2110 Enter Payout Currency Code
2111 Invalid Payout Currency Code accepts alphabets only
2112 Invalid Payout Currency Code
2113 Enter Payin Currency Code
2114 Invalid Payin Currency Code accepts alphabets only
2115 Invalid Payin Currency Code
2116 Enter Amount
2117 Invalid Amount
2118 Enter send Amount flag
36
www.xpressmoney.com
2119 Sending Amount Flag should not be empty, provide either PAYIN or PAYOUT
2120 Enter Account Name
2121 Invalid Account Name accepts alphabets only
2122 Enter Account Number
2123 Account Number accepts numbers only
2124 Enter Account Number or Account IBAN
2125 Special Characters are not allowed in Account IBAN
2126 Account Additional Number 1 accepts numbers only
2127 Account Additional Number 2 accepts numbers only
2128 Beneficiary SMS Notify accepts numbers only
2129 Enter Bank Name
2130 Invalid Bank Name accepts alphabets only
2131 Enter Bank Code
2132 Bank Code accepts numbers only
2133 Enter Bank Branch Name
2134 Invalid Bank Branch Name accepts alphabets only
2135 Enter Mobile Wallet Country Code
2136 Mobile Wallet Number should not exceed 15 digits
2137 Mobile Wallet Country Code accepts numbers only
2138 Enter Mobile Wallet Number
2139 Mobile Wallet Country Code accepts numbers only
2140 Enter Card Number
2141 Card Number accepts numbers only
2142 Enter Card Type
2143 Card Type accepts numbers only
2144 Customer Age should be greater than 18
2145 Could not get Payin Currency
2146 Invalid Payout Currency for the Receiving Agent Code
2147 Payout Amount is more than the Payout Amount Limit
2148 Could not get Service Provider Code for Sending Agent
2149 Invalid Payout Currency for the Sending Agent Code
2150 Enter Customer ID Type
2151 Customer ID Type is not Enabled for this Country
2152 Enter CustomerID Number
2153 CustomerID should not exceed 24 characters
2154 Enter Customer ID IssuedBy
2155 Enter Customer ID IssuedAt
2156 Enter Customer ID Issue Date
2157 Enter Customer ID Valid Thru
2158 Enter Customer DOB
2159 Invalid Customer ID IssueDate
2160 Invalid Customer ID, Your card is expired
2161 Invalid Customer ID IssueDate or Validity Date
2162 Enter Customer Address Zip Code
2163 Customer Address Zip Code should not exceed 4 digits
2164 Invalid Customer Address Zip Code
2165 Enter Beneficiary Relationship
37
www.xpressmoney.com
2166 Payin Amount is more than the Payin Amount Limit
2167 Payout Amount is more than the Payout Amount Limit
2168 Invalid Customer Address Country Code for given sending Agent
2169 Customer Primary Contact Number should not exceed 15 digits
2170 Customer Primary Contact Number should not exceed 15 digits
2171 Customer Secondary Contact Number should not exceed 35 digits
2172 Customer Secondary Contact Number should not exceed 35 digits
2173 Special Characters and numbers are not allowed in customerPlaceOfBirth
2174 Beneficiary Phone Number should not exceed 35 digits
2175 Beneficiary Mobile Number should not exceed 15 digits
2176 Enter the Xpin
2177 Xpin should be 16 digits
2178 Xpin accepts numbers only
2179 Invalid Xpin
2180 Enter Country Code
2181 Invalid Country Code
2182 Enter Amount Type
2183 Amount Type should be Send/Receive
2184 Enter From Currency Code
2185 Invalid Form Currency Code
2186 Enter To Currency Code
2187 Invalid To Currency Code
2188 Enter From Country Code
2189 Invalid From Country Code
2190 Enter To Country Code
2191 Invalid ToCountry Code
2192 Invalid Payment Mode . Following are the valid Payment Mode:- CS, DC, CC
2193 IncludeCharges Type should be Y/N
2194 IP Address Field is mandatory
2195 Invalid Transaction Source. Following are valid 1 = Agent, 2 = Online, 3 = Mobile
2196 Transaction Source accepts numbers only
2197 Enter Customer Fax
2198 Enter Customer Fax Country Code
2199 Customer Fax accepts numbers only
2200 Enter Cancellation Reason
2201 Invalid cancellation reason, It should be either 1 (Cancel and Refund ) or 2 (Cancel and
Reissue).
2202 ServiceType should be Send/Receive
2203 Zip Code accepts numbers only
2204 Invalid Parameters
2205 Xpin does not exists!
2206 Invalid PaymentMode
2207 Enter AuthorizationCode
2208 AuthorizationCode does not accept special characters
2209 Invalid XM Loyalty No
2210 Invalid XM Loyalty No or XM Customer No
2211 Your not authorized to check the status.
38
www.xpressmoney.com
2212 Sending agent code should not be empty.
2213 Sending agent code should be 12 digits and alpha numeric.
2214 Receiving agent code should not be empty.
2215 Receiving agent code should be 12 digits and alpha numeric.
2216 Service provider should not be empty.
2217 Service provider should be UAEEXAE#####.
2218 Your not authorized.
2219 Agent code should not be empty.
2220 Xpin sould be 16 digits.
2221 Customer does not belong to your country
2222 Invalid date entered in customerIDIssueDate, kindly follow the format as 'dd-mm-yyyy'
2223 Invalid date entered in customerIDValidThru, kindly follow the format as 'dd-mm-yyyy'
2224 Invalid date entered in customerDateOfBirth, kindly follow the format as 'dd-mm-yyyy'
2225 AuthorizationCode should be 6 characters
2226 This Delivery Option is not available for the country.
2227 Invalid Session ID
2228 Customer Address Zip Code should not exceed 4 digits.
2229 CustomerSecondaryIDType Required
2230 Enter Customer Secondary ID Number
2231 Enter Customer Secondary ID IssuedBy
2232 Enter Customer Secondary ID IssuedAt
2233 Enter Customer Secondary ID Issuance Country
2234 Invalid date entered in customerSecondaryIDIssueDate, kindly follow the format as 'dd-mm-
yyyy'
2235 Invalid date entered in customerSecondaryIDValidThru, kindly follow the format as 'dd-mm-
yyyy'
2236 BeneficiaryAddressZip or BeneficiaryPhone is mandatory
2237 Provide the CheckStatus either 1 for [Reserve the transaction ], 4 for [Release the
transaction ]
2238 Reserve & Release [(or) Maker & Checker] Facility is Not Allowed For This Agent
2239 Re-check country code in receiving agent code to receive this Xpin
2240 Re-check DeliveryOption to receive this Xpin
2241 Invalid Status, Status either 1 for [Reserve the transaction ], 4 for [Release the transaction ]
2242 Please enter the Reason for Release the transaction
2243 The Stop Payment request has already been sent for Approval
2244 Stop Payment Request Approved for cancellation
2245 Given Xpin has been picked up for transmitted
2246 Invalid Agent Code
2247 Enter Cancellation Reason Description
2248 Invalid delivery option. Following are the valid delivery options:- AC, DS, EC, MW
2249 Enter Beneficiary Address1
2250 Re-check the Xpin Only PS delivery options are allowed
2251 Re-check the Session ID to receive this Xpin
2252 Enter Beneficiary ID Type
2253 Enter Beneficiary ID
2254 Enter Beneficiary ID Issue Date
2255 Invalid Date of Birth
2256 Special Characters are not allowed in Beneficiary ID IssuedBy
39
www.xpressmoney.com
2257 Special Characters are not allowed in Beneficiary ID IssuedAt
2258 Enter Delivery Date
2259 Invalid date entered in deliveryDate, kindly follow the format as 'dd-mm-yyyy'
2260 Invalid date entered in beneficiaryIDIssueDate, kindly follow the format as 'dd-mm-yyyy'
2261 Enter Beneficiary ID ValidThru
2262 Invalid date entered in beneficiaryIDValidThru, kindly follow the format as 'dd-mm-yyyy'
2263 Enter Beneficiary Date Of Birth
2264 Invalid date entered in beneficiaryDateOfBirth, kindly follow the format as 'dd-mm-yyyy'
2265 Enter Beneficiary Employer Phone Country Code
2266 Beneficiary Employer Phone Country Code accepts numbers only
2267 Enter Beneficiary Employer Phone Number
2268 Beneficiary Employer Phone accepts numbers only
2269 Re-check the Receiving Agent Code to receive this Xpin
2270 Enter Session ID
2271 Letter From Beneficiary accepts numbers only
2272 No Rates Found
3010 Contact XM Support Centre (+971-2-6105560)
3011 Cancelled Paid Transaction
3012 Completed - Cancelled by Sender/Agent
3013 Completed - Credited to beneficiary's account
3014 Completed - Received by beneficiary
3015 Quarantined - Pickup time expired
3016 Quarantined - Transaction under compliance verification
3017 Suspended - Remittance Reserve
3018 Denied - Transmission has been rejected
3019 Revoked - Transmission has been revoked
3020 Pending - Waiting for the Cancellation Approval
3021 Authorized - Cancellation request has been Authorized
3022 Denied - Cancellation request has been denied
3023 Transmitted - Available at Destination
3024 Released - Available for cancellation only
3025 Sent - Ready for pickup at destination
3026 TxnStatus not available at this time, try again later ..!
3027 Processed - Pending for Authorization
3028 Invalid Xpin
6.3 Country Information
Country Name Country Currency Currency Nationality Nationality Country

Code Code Name Code Dial
Code
ANDORRA AD Andorran AD 376
UNITED ARAB AE AED ARAB UAE National AE 971
EMIRATES EMIRATE
DIRHAMS
AFGHANISTAN AF AFA AFGHANI Afghani AF 93
40
www.xpressmoney.com
AFGHANISTAN AF AFC AFRICAN Afghani AF 93
CURRENCY
ANTIGUA AND AG Antiguans AG 1809
BARBUDA
ANGUILLA AI Anguillan AI 1809
ALBANIA AL ALL ALBANIA - LEK Albanian AL 355
ARMENIA AM AMD ARMENIAN Armenian AM 374
DRAM
NETH ANTILLES AN Dutch Antillean AN 599
ANGOLA AO AON KWANZA Angolan AO 244
ARGENTINA AR ARS ARGENTINE Argentine AR 54
PESO
AUSTRIA AT ATS AUSTRIAN Austrian AT 43
SCHILLING
AUSTRALIA AU AUD AUSTRALIAN Australian AU 61
DOLLARS
ARUBA AW AWG ARUBAN Aruban AW 297
GUILDER
AZERBAIJAN AZ AZM US Azerbaijani AZ 994
BOSNIA AND BA BAM DEMARK Bosnian BA 387
HERZEGOVINA
BARBADOS BB BBD BARBADOS Barbadian BB 809
DOLLAR
BANGLADESH BD BDT BANGLADESH Bangladeshi BD 880
TAKA
BELGIUM BE BEF BELGIAN Belgian BE 32
FRANCS
BURKINA FASO BF Burkinabe BF 226
BULGARIA BG BGL US Bulgarian BG 359
BAHRAIN BH BHD BAHRAINI Bahraini BH 973
DINARS
BURUNDI BI BIF BI FRANC Burundian BI 257
BENIN BJ Beninese BJ 229
BERMUDA BM BMD BM Bermudian BM 1809
BRUNEI BN Bruneian BN 673
DARUSSALAM
BOLIVIA BO BOV MYDOL Bolivian BO 591
BRAZIL BR BRL BRAZILIAN Brazilian BR 55
REAL
BAHAMAS BS BSD BAHAMIAN Bahamian BS 1809
DOLLAR
BHUTAN BT BTN BHUTANESE Bhutanese BT 975
NGULTRUM
BOTSWANA BW BWP PULA Botswanaian BW 267
BELARUS BY BYR Belarussian Belarusian BY 375
Rouble
BELIZE BZ BZD BELIZE Belizean BZ 501
DOLLAR
CANADA CA CAD CANADIAN Canadian CA 1
41
www.xpressmoney.com
DOLLARS
CONGO THE CD Congolese CD 243
DEMOCRATIC
REPUBLIC OF THE
CENTRAL AFRICAN CF Central African CF 236
REPUBLIC
CONGO CG CDF Congo, Dem. Congolese CG 242
Rep. Franc
SWITZERLAND CH CHF SWISS Swiss CH 41
FRANCS
COTE D IVOIRE CI Ivorian CI 225
COOK ISLANDS CK Cook Islander CK 682
CHILE CL CLP CHILEAN Chilean CL 56
PESO
CAMEROON CM KMF Comorian Cameroonian CM 237
Franc
CHINA CN CNY YUAN Chinese CN 86
RENMINBI
COLOMBIA CO COG AN GUILDER Colombian CO 57
COLOMBIA CO COP COLOMBIAN Colombian CO 57
PESO
CAPE VERDE CP CP 238
COSTA RICA CR CRC COSTA RICAN Costa Rican CR 506
COLON
SERBIA AND CS CS
MONTENEGRO
CUBA CU Cuban CU 53
CYPRUS CY CYP CYPRUS Cypriot CY 357
POUNDS
CZECH REPUBLIC CZ CZK CZECH Czech CZ 42
KORUNA
GERMANY DE DEM GERMAN German DE 49
MARKS
DJIBOUTI DJ DJF DJIBOUTI Djibouti DJ 253
FRANC
DENMARK DK DKK DANISH Dane DK 45
KRONER
DOMINICA DM Dominican DM 1809
DOMINICAREPUBLIC DO DOP DOMINICAN Dominican DO 1809
PESO
ALGERIA DZ DZD ALGERIA Algerian DZ 213
ECUADOR EC ECS SUCRE Ecuadorean EC 593
ESTONIA EE EEK KROON Estonian EE 372
EGYPT EG EGP EGYPTIAN Egyptian EG 20
POUNDS
ERITREA ER ERN ERITREA Eritrean ER 291
SPAIN ES ESP SPANISH Spaniard ES 34
PESETA
ETHIOPIA ET ETB ETHIOPIAN Ethiopian ET 251
BIRR
42
www.xpressmoney.com
FINLAND FI FIM Finnish Markka Finn FI 358
FIJI FJ FJD FIJI DOLLAR Fijian FJ 679
FAEROE ISLANDS FO Faroese FO 298
FRANCE FR FRF FRENCH French FR 33
FRANCS
GABON GA Gabonese GA 241
GUINEA BISSAU GB GB 245
GRENADA GD Grenadian GD 1809
GEORGIA GE GEL Georgia, Lari Georgian GE 995
FRENCH GUIANA GF French GF 594
Guianese
GUERNSEY GG Channel GG
Islander
GHANA GH GHC Ghana Cedi Ghanaian GH 233
GIBRALTAR GI GIP Gibraltar Pound Gibraltarian GI 350
GREENLAND GL Greenlander GL 299
GAMBIA GM GMD Gambia Dalasi Gambian GM 220
GUINEA GN GNF GUINEA Guinean GN 224
FRANC
GUADELOUPE GP Guadeloupian GP 590
EQUATORIAL GQ Equatorial GQ 240
GUINEA Guinean
GREECE GR GRD GREEK Greek GR 30
DRAKHMAI
GUATEMALA GT GTQ Guatemala Guatemalan GT 502
Quetzal
GUAM GU Guamanian GU 671
GUYANA GY GYD Guyana Dollar Guyanese GY 592
HONG KONG HK HKD HONG KONG Hongkonger HK 852
DOLLARS
HONDURAS HN HNL Honduras HN 504
Lempira
CROATIA HR HRK Croatia Kuna Croats HR 385
HAITI HT HTG Haiti Gourde Haitian HT 509
HUNGARY HU HUF Hungary Forint Hungarian HU 36
INDONESIA ID IDR INDONESIA Indonesian ID 62
RUPIYAH
IRELAND IE IEP IRISH PUND Irish IE 353
ISREAL IL ILS Israel Shekel Israeli IL 972
ISLE OF MAN IM ISLE OF MAN IM
INDIA IN INR INDIAN Indian IN 91
RUPEES
IRAQ IQ IQD IRAQI DINAR Iraqi IQ 964
IRAN IR IRR IRANIAN Iranian IR 98
RIALS
ISLAND IS ISK Icelandic Krona Icelander IS
43
www.xpressmoney.com
ITALY IT ITL ITALIAN LIRA Italians IT 39
JERSEY JE Channel JE
Islander
JAMAICA JM JMD Jamaican Jamaican JM 1876
Dollar
JORDAN JO JOD JORDANIAN Jordanian JO 962
DINAR
JAPAN JP JPY JAPANESE Japanese JP 81
YEN
KENYA KE KES KENYAN Kenyan KE 254
SHILLING
KYRGYZSTAN KG KGS US DOLLAR Kyrgyz KG 996
CAMBODIA KH KHR Cambodia Riel Cambodian KH 855
COMOROS KM Comoros KM 269
SAINT KITTS AND KN Kittian and KN 1809
NEVIS Nevisian
KOREA KR Korean KR 82
KUWAIT KW KWD KUWAITI Kuwaiti KW 965
DINAR
KAZAKHSTAN KZ KZT Kazakhstan Kazakhstani KZ 7
Tenge
LAOS LA LA 856
LEBANON LB LBP Lebenese Lebanese LB 961
Pound
SAINT LUCIA LC Saint Lucian LC 1758
LIECHTENSTEIN LI Liechtensteiner LI 423
SRI LANKA LK LKR SRI LANKAN Sri Lankan LK 94
RUPEES
LIBERIA LR LRD US DOLLAR LIBERIA LR 0
LESOTHO LS LSL RAND Mosotho LS 266
LITHUANIA LT LTL LITHUANIAN Lithuanian LT 370
LITAS
LUXEMBOURG LU LUF BELGIAN Luxembourger LU 352
FRANC
LATVIA LV LVL LATVIAN LATS Latvian LV 371
LIBYAN ARAB LY Libyan LY 218
JAMAHIRIYA
MOROCCO MA MAD MOROCCON Moroccan MA 212
DIRHAM
MONACO MC Monegasque MC 33
MOLDOVA MD MDL MOLDOVAN Moldovan MD 373
REPUBLIC LEU
MADAGASCAR MG MGF MALAGASY Malagasy MG 261
FRANC
MACEDONIA THE MK MKD DE MARK - US Macedonian MK 389
FORMER DOLLAR
YUGOSLAV
REPUBL.OF
MALI ML Malian ML 223
44
www.xpressmoney.com
MYANMAR MM MMK MYANMAR Myanmar MM 95
KYAT
MONGOLIA MN Mongolian MN 976
MACAU MO Macau MO 853
NORTHERN MP NORTHERN MP 1670
MARIANA ISLANDS MARIANA
ISLANDS
MARTINIQUE MQ Martiniquais MQ 596
MAURITANIA MR MRO Mauritania Mauritanian MR 222
Ouguiya
MALTA MT MTL MALTESE Maltese MT 356
LIRA
MAURITIUS MU MUR MU RUPEE Mauritian MU 230
MALDIVES MV Maldivian MV 960
MALAWI MW MWK KWACHA Malawian MW 265
MEXICO MX MXN MEXICAN Mexican MX 52
PESO
MALAYSIA MY MYR MALAYSIAN Malaysian MY 60
RINGGIT
MOZAMBIQUE MZ MZM METICAL Mozambican MZ 258
NAMIBIA NA NAD NAMIBIAN Namibian NA 264
DOLLAR
NAMIBIA NA NAG NA GUILDER Namibian NA 264
NEW CALEDONIA NC New NC 687
Caledonian
NIGER NE Nigerien NE 227
NIGERIA NG NGN NAIRA Nigerian NG 234
NICARAGUA NI NIO CORDOBA Nicaraguan NI 505
ORO
NETHERLANDS NL NLG NETHERLAND Dutch NL 31
GUILDERS
NORWAY NO NOK NORWEGIAN Norwegian NO 47
KRONER
NEPAL NP NPR NEPALI Nepalese NP 977
RUPEE
NEW ZEALAND NZ NZD NEWZEALAND New Zealander NZ 64
DOLLARS
OMAN OM OMR OMANI RIYAL Omani OM 968
PANAMA PA PAB BALBOA Panamanian PA 507
PERU PE PEN NUEVO SOL Peruvian PE 51
FRENCH PF French PF 689
POLYNESIA Polynesian
PAPUA NEW PG Papua New PG 675
GUINEA Guinean
PHILIPPINES PH PHP PHILIPPINE Filipino PH 63
PESO
PAKISTAN PK PKR PAKISTAN Pakistani PK 92
RUPEES
POLAND PL PLN ZLOTY Pole PL 48
45
www.xpressmoney.com
PUERTO RICO PR Puerto Rican PR 1809
PALESTINE PS Palestinian PS 970
PORTUGAL PT PTE PORTUGUESE Portuguese PT 351
ESCUDO
PALAU PW PW 680
PARAGUAY PY PYG GAURANI Paraguayan PY 595
QATAR QA QAR QATARI RIYAL Qatari QA 974
REUNION RE Reunionese RE 262
ROMANIA RO ROL LEU Romanian RO 40
RUSSIA RU RUR RUSSIAN Russian RU 7
FEDERATION RUBLE
RWANDA RW RWF RWANDAN RWANDAN RW 250
FRANCS
KINGDOM OF SAUDI SA SAR SAUDI RIYAL Saudi or Saudi SA 966
ARABIA Arabian
SOLOMON ISLANDS SB Solomon SB 677
Islander
SEYCHELLES SC SCP SCOTISH Seychellois SC 248
POUND
SUDAN SD SDD SUDANI Sudanese SD 249
DINAR
SWEDEN SE SEK Swedish Swede SE 46
Kroner
SINGAPORE SG SGD SINGAPORE Singaporean SG 65
DOLLARS
SLOVENIA SI SIT TOLAR Slovene SI 386
SLOVAKIA SK SKK SLOVAK SLOVAKIA SK 42
KORUNA
SIERRA LEONE SL SLL LEONE SIERRA SL 232
LEONEAN
SAN MARIO SM SMG AN GUILDER Sammarinese SM 378
SENEGAL SN Senegalese SN 221
SOMALIA SO SOS SOMALI Somalian SO 252
SHILLING
SURINAME SR SRG SURINAM Surinamer SR 597
GUILDER
SAO TOME AND ST ST 239
PRINCIPLE
EL SALAVADOR SV SVC EL SALVADOR Salvadoran SV 503
COLON
SYRIAN ARAB SY SYP SYRIAN Syrian SY 963
REPUBLIC POUNDS
SWAZILAND SZ SZL LIANGENI Swazi SZ 268
TURKS AND CAICOS TC TURKS AND TC 1809
ISLAND CAICOS
ISLAND
CHAD TD Chadian TD 235
TOGO TG Togolese TG 228
THAILAND TH THB THAI BHAT Thai TH 66
46
www.xpressmoney.com
TIMOR LESTE TI TI 670
TAJIKISTAN TJ TJS SOMONI Tajik or TJ 7
Tadzhik
TURKMENISTAN TM TMM US DOLLAR TM 7
TUNISIA TN TND TUNISIAN Tunisian TN 216
DINAR
TONGA TO TOP Tongan TO 676
Paanga
TURKEY TR TRL TURKISH LIRA Turkish TR 90
TRINIDAD AND TT TTD Trinidad & Trinidadian TT 1809
TOBAGO Tobago Dollar
TAIWAN TW TWD New Thaiwan Taiwanese TW 886
Dollar
TANZANIA TZ TZS Tanzanian Tanzanian TZ 255
Shilling
UKRAINE UA UKRAINE UA 380
UGANDA UG UGX Ugandian Ugandan UG 256
Shilling
UNITED KINGDOM UK GBP STERLING British UK 44
POUNDS
UNITED STATES US USD US DOLLARS American US 1
URUGUAY UY UYU Uruguayan Uruguayan UY 598
Peso
UZBEKISTAN UZ UZS Uzbekistani Uzbekistani UZ 998
Sum
HOLY SEE VA VUV Vanuatu Vatu VA
SAINT VICENT AND VC Vincentian VC 1784
THE GRENADINES
VENEZUELA VE VEB Venezuela Venezuelan VE 58
Bolivar
VIRGIN ISLAND VG British Virgin VG 2E+05
BRITISH Islander
VIRGIN ISLAND US VI Virgin Islander VI 1809
VIETNAM VN VND Vietnam Dong Vietnamese VN 84
VANUATU VU Ni-Vanuatu VU 678
WALLIS AND WF Wallisian, WF 681
FUTUNA ISLAND Futunan
WEST INDIES WI WI
SAMOA WS Samoan WS 685
YEMEN YE YER YEMENI RIAL Yemeni YE 967
MAYOTTE YT Mahorais YT 269
YUGOSLAVIA YU YUM YUGOSLAVIA Yugoslavian YU 381
DINARA
DUPLICATE Z1 Z1 376
SOUTH AFRICA ZA ZAR SOUTH South African ZA 27
AFRICAN
RAND
ZAMBIA ZM ZMK KWACHA Zambian ZM 260
47
www.xpressmoney.com
ZIMBABWE ZW ZWD ZIMBABWE Zimbabwean ZW 263
DOLLAR
6.4 ID Types and ID Code
ID Code IDTypes
1 Govt.ApprovedID
2 SocialSecurityNo
3 Passport
4 WorkPermit
5 DrivingLicense
6 Edu.InstitutionID
7 Govt.Department ID Card
8 UAE National ID Card
9 AGCC National ID Card
10 UAE Health Card
11 SeaMan Out Pass
12 AirLine Crew ID Card
13 Trade License
14 E-Gate Card
15 EIA ID
16 Kuwait Civil ID
17 Emirates ID
18 Age Card
19 Birth Certificate
20 Hong Kong Identity Card
21 Citizenship Card
22 Computerized National Identity Card
23 Employment Authorization Card
24 Full UK Driving License
25 Mexican Electoral Card
26 National ID Card
27 Native American Tribal ID
28 Permanent Resident Card
29 Resident Alien Card
30 State ID
31 Temporary Resident Card
32 CPR ( Central Population Record )
33 Smart Card
34 IQAMA
35 Diplomatic Card - Foreigner
48
www.xpressmoney.com
36 Doc.code for migration ID
37 Family Registration Book
38 Special Diplomatic Passport
39 Judicial identity Card
40 Military identity Card
41 Border Crossing Card
42 ER Card - Al Rajhi
43 Employee ID
44 Student ID
45 Photo ID
46 MyKad/National ID Card
47 Stay Visa Card
48 Election ID
49 Pink Slip
50 Alien Book
51 UN ID
52 Military ID
53 National ID
54 CIN
55 SIN
56 Health Card
57 OMANG ID CARD
58 PRC - Professional Regulations Commission ID
59 Senior Citizen card
60 IBP - Integrated Bar of the Phils ID
61 NBI - National Bureau of Investigation Clearance
62 Police clearance
63 Postal ID
64 Barangay certification
65 GSIS - Government Service Insurance System
66 SSS - Social Security System card
67 OWWA - Overseas Workers Welfare Administration ID
68 OFW ID
70 ACR - Alien Certificate of Registration
71 Immigrant Certification of Registration
72 AFP - Armed Forces of the Philippines ID
73 NCWDP - National Council for Welfare of Disabled Persons
74 DSWD - Department of Social Welfare and Development
75 BIR - Bureau of Internal Revenue Taxpayers ID
76 Firearms License
49
www.xpressmoney.com
77 Diplomat ID
78 PLRA - Philippine Leisure and Retirement Authority ID
79 Company ID - issued by BSP
80 Company ID - issued by SEC
81 Company ID - issued by IC
82 Phil health Card
83 Immigrant Certificate of Registration
84 Government office and GOCC ID
99 Others
100 Permanent Resident Identity Card of Macau
101 Mainland Travel Permit for Taiwan Residents
102 Taiwan Travel Permit for Mainland Residents
103 Seaman Identity Card
104 PAN Card
105 HongKongID
106 Kenyan National ID
107 Omang Identity card
108 Alien Card- Kenya
109 MYKad IC
110 GCC Card
111 Sin Card
112 ETIMATOKIYA
113 CIS Passport
114 Mexican Matricula ID Card
115 Citizenship Scrutining Card
125 Saudi Passport
126 Diplomatic Passport
6.5 Purpose of Transaction
PurposeCode PurposeDescription
DOE DOE
DOM DOMESTIC TRANSFER
P01 FAMILY MAINTENANCE/SAVINGS
P02 INVESTMENT IN NRI DEPOSITS
P03 OTHER INVESTMENT INCOME
P04 PROFESSIONAL/TECHINICAL FEES
P05 REPAYMENTS OF LOANS AND ODs
P07 TOURIST EXPENSES
P08 INSURANCE PAYMENTS
P09 POSTAL/TELECOM SERVICES
50
www.xpressmoney.com
P10 SUBSCRIPTIONS OF PERIODICALS
P11 COMPUTER AND IT SERVICES
P12 ROYALTY AND LICENSE FEES
P13 REFUNDS/REBATE ON TRADE
P14 OTHER INWARD REMITTANCES
P15 INTEREST ON LOANS TO NON-RESIDENTS
P16 DIVIDENDS/PROFITS
P17 INTEREST ON DEBUNTURES/FRNs
P18 PAYMENT/REFUND OF TAXES
P19 MEDICAL
P20 CONSULTANCY
P21 INVESTMENT IN HOSUING
P22 MEDICAL EXPENSES
P23 EDUCATTIONAL EXPENSES
P24 TRAVEL AND TOURS
P25 INVESTMENT IN SHARES/DEBENTURES/BONDS
P26 INSURANCE PAYMENTS
P27 TRADE TRANSACTIONS
P29 PAYMENT OF SALARIES
P51 INVESTMENT IN REAL ESTATE
P52 INVESTMENT IN EQUITY SHARES
P53 INVESTMENT IN SECURITIES
P54 REPAYMENT OF LOANS
P55 BUSINESS TRAVEL
P56 INSURANCE PREMIUM
P57 OTHER REMITTANCES
P58 FAMILY MAINTENANCE/SAVINGS
P59 INTEREST ON LOANS
P60 REPATRIATION OF BUSINESS PROFITS
P61 TRADE REMITTANCES
P62 EDUCATIONAL EXPENSES
P63 HOTEL EXPENSES
P64 MEDICAL EXPENSES
P65 PERSONAL TRAVELS & TOURS
6.6 Source of Income
SourceOfIncomeCode SourceOfIncomeDescription
S01 SALARY
S02 BUSINESS
S03 SAVINGS
51
www.xpressmoney.com
S04 LOTTERY
S05 GIFT
S06 FINAL SETTLEMENT
S07 LOAN FROM BANK
S99 CREDIT CARD
S01 Salary
S02 Business
S03 LOTTERY
7. Integration Life Cycle
Initiation – After scheduling the integration support, we will share the test plan along with project charter which
will consist of the test cases and configuration details required for you to start the testing process. Project
Charter will also define the tentative time lines during which the partner needs to complete the testing.
Testing – This will be the actual testing phase where our integration support team will provide all the
assistance and guidance (weekdays 9 AM to 6 PM IST) required by the partner to successfully test all the
integration methods and test cases.
Sign off – Once the testing is completed successfully, partner will be required to share sign off for all the test
cases and methods successfully tested. Only after the sign off is received live user credentials can be shared.
Production – After receiving sign off, XM Implementation team will require 5-7 business days to configure the live
credentials and share with the partner for going live.
CONTACT US
Xpress Money Web Service Integration Support

XM Software Solutions Pvt Ltd. | SKCL | CENTRAL SQUARE - II
CIPET Road | Thiru-Vi-Ka Industrial Estate | Guindy | Chennai - 600032
Email: partner.integrations@xpressmoney.com | xm.pre@xpressmoney.com
52

Xpress Money - API - 2.0 Manadtory PDF

Uploaded by

Document Information

Original Description:

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Xpress Money - API - 2.0 Manadtory PDF

Uploaded by

Copyright:

Available Formats

XPRESS MONEY | API

TRAINING | PROCESS REENGINEERING

Prepared by Training & PRE

7. Integration Life Cycle .............................................................................................................................. 52

Sender communicates the 16-digit XPIN number to the Receiver

How to Send Money

Receives cash. Sender gets instant SMS notification upon collection

How to Receive Money

1. Send Remittance Methods

1.1 CreateXMTransaction Method

Request Field Description:

Field Name Data Type Length Acceptable Characters

1.2 EditXMTransaction Method

Request Field Description:

Field Name Data Type Length Acceptable Characters

Response Field Description:

1.3 ConfirmXMTransaction Method

a. Once the Method ConfirmXMtransaction is called, transaction will be successfully created in XM

Request Field Description:

Response Field Description:

2. Receive Remittance Methods

2.1 getAllOutstandingTransactions Method

Request Field Description:

Field Name Data Type Length Acceptable Characters

Response Field Description

Field Name Data Type Length Acceptable Characters

2.2 updateAllOutstandingtxnlist Method

Request Field Description:

Field Name Data Type Length Acceptable Characters

Response Field Description:

Field Name Data Type Length Acceptable Characters

2.3 confirmAllOutstandingReceiveTxn Method

Request Field Description:

Field Name Data Type Length Acceptable Characters

Response Field Description:

Field Name Data Type Length Acceptable Characters

2.4 getXMReceiveTxn Method

Request Field Description:

Field Name Data Type Length Acceptable Characters

Response Field Description:

Field Name Data Type Length Acceptable Characters

2.5 confirmXMReceiveTxn Method

Request Field Description:

Field Name Data Type Length Acceptable Characters

Response Field Description:

3.1 getXMSCancelTxn Method

a. You can cancel a transaction by calling the getXMSCancelTxn method.

Response Field Description:

3.2 ConfirmXMSCancelTxn Method:

Request Field Description:

Field Name Data Type Length Acceptable Characters

Response Field Description:

Field Name Data Type Length Acceptable Characters

4.1 getXMRateCalculateDetails Method:

Request Field Description:

Field Name Data Type Length Acceptable Characters

Response Field Description:

Field Name Data Type Length Acceptable Characters

4.2 getXMAgentDetails Method

Request Field Description:

Field Name Data Type Length Acceptable Characters

Response Field Description: