Tokenisation Merchant Ation Data Cash Developers Guide Appendices V2.31

User Manual:

Open the PDF directly: View PDF PDF.
Page Count: 65

DownloadTokenisation Merchant Ation Data Cash Developers Guide Appendices V2.31
Open PDF In BrowserView PDF
Developer’s Guide
Appendices

Prepared for:
DataCash

Date:
18 April 2013

© 2013 DataCash. All rights reserved.
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

Document Control
Reference

APIAPP001

Date

18/04/2013

File Name

DataCash_Developers_Guide_Appendices_v2.31

Version

2.31

REVISION HISTORY
Revision

Date

Comments / Reason

2.0

26/11/09

Release; consolidation of DPG and APG

2.1

11/01/10

InstaDebit & ExperCash details added

2.2

02/02/10

Updated Envoy Banking Services (remove POLiGB)

2.3

04/03/10

Added ACS Simulator and Magic Card Facility

2.4

26/04/10

Update Appendix 19 – New TypeofAction and ErrorCode
entries

2.5

06/05/10

Updated Appendix 17 – Added New Envoy Banking Services

2.6

25/05/10

Updated table of contents

2.7

15/06/10

Update to title, date field

2.8

09/09/10

Update to Envoy products and countries

2.9

19/10/10

Update to Envoy products and countries (JF)
Update to Appendix 6 – new EL error codes(HA)
Update to Appendix 7 – inclusion of EL (HA)
Added Appendix 20, 21, 22 – eCheck specific information(HA)

2.10

25/10/10

Addition of recommended Client Messaging for APG products
(JF)

2.11

11/11/10

Update to Envoy Products – Banco Santander Correction &
Dinero Mail Currency (JF)

2.12

21/12/10

Update to MoneyBookers Payment Methods Appendix 16: code
of codes for PostePay and Carte Si, addition of OBT, removal
of 4B and Euro6000 (JF)
Update to GluePay countries: removal of Norway, Denmark,
Lithuania and Latvia (JF)

2.13

16/02/11

Added Appendices 24, 25, 26 – RSG (Risk Services Gateway)
Specific information (DEJ)

2.14

18/02/11

Added Envoy OneClick Payout fields in Appendix 17 (MAS)

2.15

06/04/11

Added Amazon Payment Method and associated error codes
(SJ)

2.16

17/05/11

Added a new service type to Appendix 17.(HA)
Updated to Appendix 17 – added ARS as a currency and
removed USD currency to the Envoy Product – DineroMail(MA)

2.17

31/05/11

Correction to Appendix 10 ISO code for Argentine Peso

2.18

08/06/11

Updated the ‘MD’ description

(SA)

Updated Envoy OneClick – CashU country list (MA)
© 2013 DataCash. All rights reserved.
Page i of iii
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

2.19

13/07/11

Added Tokenisation

2.20

19/07/11

Updated MB Split Gateway OBT to include Italy

2.21

20/07/2011

Added a new service type to Appendix 7, as well as add
Appendix 28 (RJB)

2.22

12/08/2011

Updated Appendix 17 for product Gluepay to include
Poland(MA)

2.23

15/08/2011

Changed spelling of Tokenisation to the US spelling:
Tokenization(MA)

2.24

26/09/2011

Updated Envoy Product table to exclude Gluepay and
formatting changes (MA)

2.25

24/10/2011

Updated the format of Appendix 28 (AM)
Update to Appendix 10 – ISO Currency Codes And
Exponents(AA)

2.26

22/12/2011

Updated to exclude Indonesian Rupiah (IDR)

2.27

05/03/2012

Updated to Exclude Envoy product: EwireNO

2.28

19/03/2012

Added POLi service type and Error Codes (RJB)

2.29

02/04/2012

Added AliPay service type and Error Codes (RJB)

2.30

04/03/2013

Added new APG error codes.

2.31

18/03/2013

Updated ClickAndBuy information

© 2013 DataCash. All rights reserved.
Page ii of iii
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

TABLE OF CONTENTS

PAGE

1.

Introduction .............................................................................. 1
1.1
Scope .............................................................................. 1
1.2
Audience .......................................................................... 1
1.3
Support ............................................................................ 1

2.

Appendices ............................................................................... 2
2.1
Appendix 1 – LID Commodity Codes .................................... 2
2.2
Appendix 2 – ACS Simulator ............................................... 6
2.3
Appendix 3 – Magic Card Facility For 3DS ............................. 8
2.4
Appendix 4 - Real Time Fraud Screening ............................ 10
2.5
Appendix 5 – Real Time Fraud Screening - Gift Occasions ..... 13
2.6
Appendix 6 – APG Status code and Error Code list ............... 14
2.7
Appendix 7 – APG Processor / Payment Method types .......... 20
2.8
Appendix 8 – State / Province / Country Code list ................ 24
2.9
Appendix 9 – Country Code List ......................................... 27
2.10 Appendix 10 – ISO Currency Codes And Exponents .............. 33
2.11 Appendix 11 – IDs Required Per Country ............................ 37
2.12 Appendix 12 – APG ClientIDNumbers Types ........................ 45
2.13 Appendix 13 – APG Languages Supported ........................... 45
2.14 Appendix 14 – APG Purchase Sources And Numeric Codes .... 46
2.15 Appendix 15 – APG Redemption Types And Numeric Codes ... 47
2.16 Appendix 16 – Moneybookers Payment Methods .................. 48
2.17 Appendix 17 – Envoy Banking Services .............................. 49
2.18 Appendix 18 – APG Information Service Type ...................... 51
2.19 Appendix 19 – Action TypeID And Descriptions .................... 51
2.20 Appendix 20 – eCheck Managed Billing Frequency Pattern Fields 52
2.21 Appendix 21 – eCheck Account Type .................................. 54
2.22 Appendix 22 – eCheck Action Type .................................... 54
2.23 Appendix 23 - Recommended Client Messaging ................... 54
2.24 Appendix 24 – Risk Services Gateway - Status Codes........... 55
2.25 Appendix 25 – Risk Services Gateway - State/Province/County Codes
55
2.26 Appendix 26 – Risk Services Gateway - Payment Method Codes59
2.27 Appendix 27 – Offline bank transfer Services ...................... 61

© 2013 DataCash. All rights reserved.
Page iii of iii
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

1.
1.1

INTRODUCTION
SCOPE

This document contains appendices to supplement the DataCash Developer’s Guide.
1.2

AUDIENCE

This document is intended to be used by developers, technical personnel and business
analysts, to facilitate a successful integration by a merchant to the payment gateways
provided by DataCash.
1.3

SUPPORT

For any assistance or information pertaining to existing or new DataCash services,
please contact Support via the DataCash website.

© 2013 DataCash. All rights reserved.
Page 1 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

2.
2.1

APPENDICES
APPENDIX 1 – LID COMMODITY CODES

These commodity codes can be used for the “Line Item Detail” (LID) Service, which is
described in Section 2.2 (Single Card Payments) of the DataCash Developer’s Guide.
Commodity
Code

Description

7461

Accounting/tax Consultancy Services

7464

Advertising And Marketing Services

3100

Agricultural Fertilisers

8800

Aircraft Parts

2200

Alcoholic Beverages

1200

Animal Feeding Stuffs

7300

Barbed Wire/fencing

0900

Beverages - Non-alcoholic

8705

Bicycles/tricycles

9000

Binoculars/telescopes

4900

Books; Printed Material

2500

Building Aggregates

6900

Building Bricks/tiles/stones

8507

Burglar & Fire Alarms

9001

Cameras/flashes

7160

Car Hire Services: Qualifying Cars

6562

Car Leasing Services: Qualifying Cars

6565

Car Leasing Services: Non - Qualifying Cars

5700

Carpets/floor Coverings

5561

Catering Services

6901

Sinks, Baths, Washbasins; Other Plumbing/heating Products

2800

Chemicals/acids

3400

Cleaning Products

7468

Cleaning Services

9100

Clocks, Watches & Parts

6200

Clothing

8701

Commercial Motor Vehicles

6563

Commercial Vehicle Leasing Services

7260

Computer Consultancy Services

8405

Computer Hardware

8406

Computer Software

7163

Computer/office Machine Rental

4560

Construction/demolition Services

0400

Dairy Produce

7261

Data Processing Services

8060

Driving Tuition Services

© 2013 DataCash. All rights reserved.
Page 2 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

Commodity
Code

Description

8509

Electric Lamps

4562

Electrical Contracting

8508

Electrical Switches/fuses/plugs/circuits

8061

Employee Training

9360

Employee Welfare Services

7466

Employment Bureau Services

6561

Equipment Leasing Services

7061

Estate Agency Services

6564

Factoring Services

6760

Financial Administration Services

6560

Financial Services (non Insurance)

8404

Fire Extinguishers

3000

First Aid Products

0300

Fish/seafood Products

6400

Footwear

6362

Freight / Carriage Charges (non Courier / Delivery Service Providers)

6061

Freight Transport Services

0800

Fruit And Fruit Products

8500

Generators/electric Motors

7000

Glassware

8200

Hand Tools

6500

Headgear

5560

Hotel/restaurant Services

8401

Industrial Engines/plant: Parts

3600

Industrial Explosives

8400

Industrial Mechanical Appliances/parts

7100

Industrial Metals (base/processed)

8402

Industrial Plant/equipment

3800

Insecticides/fungicides/disinfectants

6660

Insurance Services - General

4565

Joinery Services

8403

Kitchen Equipment

4200

Leather Cases And Bags

7460

Legal Services - Lawyers/solicitors

9261

Library/archiving Services

0100

Live Animals

2702

Lubricating Oils

8201

Machine Tools

8202

Machine/hand Tool Parts

7262

Maintenance/repair - Office Equipment

7463

Management Consultancy Services

© 2013 DataCash. All rights reserved.
Page 3 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

Commodity
Code

Description

7462

Market Research Services

9004

Measuring Equipment

0200

Meat/meat Products

9260

Media/news Agency Services

8560

Medical Services

9160

Membership Subscriptions

9003

Microscopes

8700

Motor Cars

8704

Motor Cycles/sidecars

8703

Motor Vehicle Parts (excluding Tyres)

5060

Motor Vehicle Repair/maintenance Services

9200

Musical Instruments

4801

Newsprint

9400

Office Furniture

4800

Office Stationery

7472

Other Business Services

6300

Packing Materials/sacks/bags

7470

Packing Services

8300

Padlocks, Locks, Keys. Safes, Strong Boxes, Other Ironmongery Products

4566

Painting/glazing Services

3200

Paints/varnishes

6060

Passenger Transport

6761

Pension Advisory/administration Services

2701

Petrol/diesel - Road Fuel

9002

Photocopiers

3700

Photographic Film Products

7469

Photographic Services

0600

Plants, Shrubs And Trees

4564

Plastering Services

4563

Plumbing, Heating And Drainage Services

6460

Courier Services (courier / Delivery Services Providers)

2261

Printing Services

7062

Property Management Services

7060

Property Rentals

2260

Publishing Services

8505

Radios

8600

Railway Locomotive Parts

8502

Record/cassette/cd Players

7161

Rental Of Agricultural Machinery

7162

Rental Of Construction Equipment

7164

Rental Of Sports/recreational Equipment

© 2013 DataCash. All rights reserved.
Page 4 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

Commodity
Code

Description

4561

Roofing Services

5600

Rope, cable, Netting

4000

Rubber Products

7471

Secretarial/translation Services

7467

Site Security Services

2700

Solid Fuel; Heating/ Industrial/ Agricultural Oils

8702

Special Purpose Vehicles

7560

Statutory Charges/licenses

6360

Storage/warehousing Services

8503

Tape Recorders/answering Machines

7465

Technical Analysis Services

6461

Telecommunications Services

8501

Telephones

8506

Television Sets

2400

Tobacco/tobacco Products

9500

Toys, Games And Models

8706

Trailers/trailer Parts

6361

Travel Agency Services

4001

Tyres - Motor Vehicles

6600

Umbrellas And Walking Sticks

9999

Vat: Insurance Repairs

0700

Vegetables And Vegetable Products

8407

Vending Machines

8504

Video Recorders

4802

Wallpaper

3760

Waste Disposal Services

4700

Wood, Timber Products, Pulp And Paper Products

© 2013 DataCash. All rights reserved.
Page 5 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

2.2

APPENDIX 2 – ACS SIMULATOR

2.2.1 Introduction
The DataCash ACS simulator enables you to simulate the behaviour of an Issuing
Bank’s ACS. This includes sending an authenticated response, a non-authenticated
response or a range of invalid and error responses.
It is intended that the ACS simulator be used during merchant integration. It can be
used to test both the “3DS With DataCash MPI” and “MPI Only” Services.
2.2.2 How to use the ACS simulator
The URL of the ACS that the cardholder is to be directed to is returned in the Enrolment
Check Response XML Document. In a test environment this will be the URL of the
DataCash ACS simulator.
The simulator gives you control over what response is returned i.e. whether to simulate
that the cardholder managed to authenticate themselves or whether an error occurred.
The following fields have to be supplied to the ACS URL using the POST method:
Field
PaReq

Description
The PaReq that was returned in the same Enrolment Check Response as the
ACS URL.

TermURL The URL of the script that will process the response from the ACS.

MD

The MD field gives you a mechanism of tracing transactions. This field should
be populated with a unique value. This value will be returned to you, with the
PaRes message, when the ACS has finished. Recommend using the
datacash_reference number of the transaction. This field must contain only
ASCII characters in the range 0x20 to 0x7E; if other data is needed, the field
must be Base64 encoded. The size of the field (after Base64 encoding, if
applicable) is limited to 1024 bytes

If any of these fields are missing then an error response will be displayed.
The output from the ACS Simulator should be displayed in a popup window, separate
from the original checkout page.
Example output from the ACS Simulator can be seen below.

© 2013 DataCash. All rights reserved.
Page 6 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

At the top of the page is information that is contained in the PaReq message. This can
be used to check that the correct details are being processed. The page also contains
four buttons that give you the ability emulate responses from a real ACS. These
buttons are:
Button

Description

Authenticated

The cardholder successfully authenticated himself or herself.

Not
Authenticated

The cardholder failed to authenticate himself or herself.

Attempt

The cardholder chose not to register their card during ADS.

Unavailable

There is a communication failure between the ACS and the Issuer’s
main system.

© 2013 DataCash. All rights reserved.
Page 7 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

The error drop down menu can be used to select which error response is to be
generated.
Error Code

Description

0 – none

No error occurred

1 - Invalid PARes Signature

Response code 174 - see FAQ

2 - Invalid PARes

Response code 176 - see FAQ

98 - Transient system failure Transient system failure i.e. system is currently busy.
99 - Permanent system
failure

Permanent system failure i.e. the database server is
down.

Once one of the four buttons has been pressed the popup window will close and the
output of the return script, as specified in the TermURL field, will be displayed in the
original checkout window.
The following fields will be supplied to the return script using the POST method:
Field

Description

PaRes

A cryptographically signed XML document used to
indicate whether or not the cardholder managed to
authenticate. It should be returned to DataCash in the
threedsecure_authorization_request message.
If an error occurs at the ACS, the PaRes will be populated
with an error message, but this should not be interpreted
or examined by the merchant

MD

This is the value that was passed with the original
request to the ACS simulator.

2.3

APPENDIX 3 – MAGIC CARD FACILITY FOR 3DS

DataCash provides a magic card facility. This allows particular responses to be received
from the DPG when using one of the magic card numbers.
The existing list of magic cards can be found in the Developers Area.
DataCash has extended this functionality to allow certain Enrolment Verification
Request responses to be obtained to test 3DS. This is achieved by specifying any of the
magic card numbers with an appropriate value for the month in the card expiry date
field.
The possible options are:
Value of month
in expiry date
01

Type of Response returned
Card is enrolled

Return
Code
150

© 2013 DataCash. All rights reserved.
Page 8 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

02

Card is not enrolled

162

03

No result received from the directory server

159

04

An invalid response is received from the directory server

160

05

The directory server is running the wrong protocol (SET
instead of 3-D Secure)

160

06

3DS Invalid VEReq

186

Any other value ‘Unable to process’ response is received from the directory
187
server
It should also be noted that if a non-magic card were used in a 3-D Secure transaction
submitted against the testserver host, a response with return code 169 would be
received, as shown below:
Example XML for error 169


...
...

...
...
TEST
3DS Merchant in test-mode supplied non-magic card
169


Please see the Developers Area and Support Centre for information on the return
codes.

© 2013 DataCash. All rights reserved.
Page 9 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

2.4

APPENDIX 4 - REAL TIME FRAUD SCREENING

The details of the “Real Time Fraud Screening” Service are outlined in Section 2.4.3
(Fraud Prevention) of the DPG part of the DataCash Developer’s Guide.
In the table below, elements are listed by ReD field name (not DataCash schema
names). This is to enable bespoke merchants to identify the DataCash elements
required to trigger all the rules set up by ReD.
The following information should be noted about these fields:
 If no Recipient is specified – the Customer Address will be used for the edSHIP
fields
 If only one Recipient is specified – the ebSHIP fields will be used in preference
to the ebRECIPIENT fields
 If more than one Recipient is specified – the ebRECIPIENT fields will be used
and the Customer Address elements will be ignored

ReD field name

DataCash Schema Element

“Real Time Fraud
Screening” Request
section

ebBILLADDRESS2

moreaddress

BillingAddress

ebBILLAPT

apartment

BillingAddress

ebBILLCITY

city

BillingAddress

ebBILLCOUNTRY

country

BillingAddress

ebBILLSTATE

region

BillingAddress

ebBILLSTREET

streetaddress

BillingAddress

ebBILLZIPCD

postcode

BillingAddress

ebCARRIER

carrier

Shipping

ebCINPRESENT

cv2_present

Cv2Avs

ebCORPADDRESS2

moreaddress

Address

ebCORPCOUNTRY

country

Address

ebCORPFAX

fax

Company

ebCORPNAME

name

Company

ebCORPPHONE

telephone

Company

ebCORPPONBR

pobox

Address

ebCORPPURCHDESC

purchase_description

Company

ebCORPSTATE

region

Address

ebCORPSTREET

streetaddress

Address

ebCORPSUITE

apartment

Address

ebCORPCITY

city

Address

© 2013 DataCash. All rights reserved.
Page 10 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

ebCORPZIPCD

postcode

Address

ebCUSTAGE

age

Customer

ebCUSTBDATE

date_of_birth

Customer

ebCUSTCOOKIES

cookies

CustomerHistory

ebCUSTEMAIL

email

Customer

ebCUSTFAX

fax

Customer

ebCUSTFIRSTNAME

forename

Customer

ebCUSTHOMEPHONE

alt_telephone

Customer

ebCUSTID

account

CustomerHistory

ebCUSTIP

ip_address

Customer

ebCUSTLASTNAME

surname

Customer

ebCUSTMAXAGE

max_age

Customer

ebCUSTMIDNAME

middlename

Customer

ebCUSTMINAGE

min_age

Customer

ebCUSTSALUTATION

salutation

Customer

ebCUSTSSN

national_id

Customer

ebCUSTTM

pctime

Customer

ebCUSTWORKPHONE

telephone

Customer

ebDEFFORMFILL

formfill

CustomerHistory

ebFORGOTPWD

forgot_password

CustomerHistory

ebGIFTCARDTYPE

attribute card

Order, LineItem

ebGIFTMSG

gift

Order, LineItem

ebHANDLING

handling

OrderDetails

ebITEMCARRIER

carrier

Shipping

ebITEMGIFTCARDTYPE

attribute card

Order, LineItem

ebITEMGIFTMESSAGE

gift

Order, LineItem

ebITEMSHIPCOMMENTS

comments

Shipping

ebITEMSHIPINSTRUCTION

instructions

Shipping

ebITEMSHIPMENTNO

tracking_number

Shipping

ebITEMSHIPMETHOD

method

Shipping

ebMANPARTNO

attribute manpartno

LineItem

ebMANUFACTURER

attribute manufacturer

LineItem

ebPASSWORD

password_access

CustomerHistory

ebPREVIOUSCUST

previous_cust

CustomerHistory

ebPRODCATEGORY

attribute category

LineItem

© 2013 DataCash. All rights reserved.
Page 11 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

ebPRODCD

attribute product_code

LineItem

ebPRODDESC

description

LineItem

ebPRODQUANTITY

attribute quantity

LineItem

ebPRODSKU

attribute sku

LineItem

ebPRODTYPE

attribute type

LineItem

ebPRODUNITPRICE

attribute unit_price

LineItem

ebRECIPIENTADDRESS2

moreaddress

Address

ebRECIPIENTAPT

apartment

Address

ebRECIPIENTCITY

city

Address

ebRECIPIENTCOUNTRY

country

Address

ebRECIPIENTEMAIL

email

Recipient

ebRECIPIENTFIRSTNAME

forename

Recipient

ebRECIPIENTLASTNAME

surname

Recipient

ebRECIPIENTMIDNAME

middlename

Recipient

ebRECIPIENTPHONE

telephone

Recipient

ebRECIPIENTSALUTATION

salutation

Recipient

ebRECIPIENTSTATE

region

Address

ebRECIPIENTSTREET

streetaddress

Address

ebRECIPIENTZIPCD

postcode

Address

ebREGLOYALTY

loyalty

CustomerHistory

ebREGPROMOS

promos

CustomerHistory

ebRETURNALLOWED

returns_allowed

Order

ebSHIPADDRESS2

moreaddress

Address

ebSHIPAPT

apartment

Address

ebSHIPCITY

city

Address

ebSHIPCOMMENTS

comments

Shipping

ebSHIPCOUNTRY

country

Address

ebSHIPEMAIL

email

Recipient

ebSHIPFIRSTNAME

forename

Recipient

ebSHIPINSTRUCTION

instructions

Shipping

ebSHIPLASTNAME

surname

Recipient

ebSHIPMENTNO

tracking_number

Shipping

ebSHIPMETHOD

method

Shipping

ebSHIPMIDNAME

middlename

Recipient

ebSHIPPHONE

telephone

Recipient

© 2013 DataCash. All rights reserved.
Page 12 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

ebSHIPSALUTATION

salutation

Recipient

ebSHIPSTATE

region

Address

ebSHIPSTREET

streetaddress

Address

ebSHIPZIPCD

postcode

Address

ebSUBTOTAL

subtotal

OrderDetails

ebTAX

tax

OrderDetails

ebTRANCATEGORY

transactionsource

TxnDetails

ebUPC

attribute upc

LineItem

ebWEBSITE

website

CustomerHistory

2.5

APPENDIX 5 – REAL TIME FRAUD SCREENING - GIFT OCCASIONS

The details of the “Real Time Fraud Screening” Service are outlined in Section 2.4.7 of
the Developer’s Guide.
Code

Description

1

Celebrate Fall

2

Grandparent's Day

4

Independence Day

A

Anniversary

B

Birthday

C

Congratulations

D

April Fool's Day

E

Easter

F

Father's Day

G

Graduation

H

Holiday

I

Season's Greeting

J

Passover

K

Kwanzaa

L

Halloween

M

Mother's Day

N

New Year's Day

O

Bosses' Day

P

St Patrick's Day

Q

Sweetest Day

R

Christmas

S

Baby Shower

© 2013 DataCash. All rights reserved.
Page 13 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

2.6

T

Thanksgiving

U

Other

V

Valentine's Day

W

Wedding

X

Secretary's Day

Y

Chinese New Year

Z

Hanukkah

APPENDIX 6 – APG STATUS CODE AND ERROR CODE LIST

Type of
Message
APG
status
codes

Type of
Message
APG error
messages

Status
Code
0
0
1
2
3
4
5
8
9
12
18
20

Error
Code
001
002
002
002
003
004
005
005
005
006
007
008
008
008
009
009
009
010

Status Description
Sent for authorisation
Information Supplied (Only for Ukash GetSettlement value)
Authorised
Pending
Error
Refused
Redirect
Sent for cancel
Cancelled
Not Found
Unknown
Fraud Rejected

Error Description
PurchaseDetails and PaymentMethodDetails must be supplied
PurchaseDetails.AccountDetails must be supplied
UKashItem.AccountItem must be supplied
AccountDetails must be supplied
PurchaseDetails.BillingDetails must be supplied
PurchaseDetails.BillingDetails.AddressDetails must be supplied
PurchaseDetails.BillingDetails.AmountDetails must be supplied
UKashItem.AmountItem must be supplied
DPGReferenceId must be supplied
PurchaseDetails.PersonalDetails must be supplied
PurchaseDetails.TransactionDateTime must be supplied
PurchaseDetails.AccountDetails.AccountName must be supplied
UKashItem.AccountDetails.AccountName must be supplied
AccountDetails.AccountName must be supplied
PurchaseDetails.AccountDetails.AccountPIN must be supplied
UKashItem.AccountDetails.AccountPIN must be supplied
AccountDetails.AccountPIN must be supplied
PurchaseDetails.AccountDetails.CompanyId must be supplied

© 2013 DataCash. All rights reserved.
Page 14 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

010
010
011
012
012
013
013
013
014
014
015
015
016
016
016
016
016
016
016
017
017
018
018
019
019
020
020
021
021
022
022
022
022
022
023
024
025

UKashItem.AccountDetails.CompanyId must be supplied
AccountDetails.CompanyId must be supplied
PurchaseDetails.PersonalDetails.DateOfBirth value invalid
PurchaseDetails.BillingDetails.AmountDetails.Amount value invalid
UKashItem.AmountDetails.Amount value invalid
PurchaseDetails.BillingDetails.AmountDetails.CurrencyCode value
invalid
UKashItem.AmountDetails.CurrencyCode value invalid
DBTItem.CurrencyCode is invalid
PurchaseDetails.TransactionId value must be supplied
UKashItem.TransactionId value must be supplied
PurchaseDetails.TransactionId must be less than or equal to 16
characters
UKashItem.TransactionId must be less than or equal to 16
characters
PurchaseDetails.TransactionId must contain _
PurchaseDetails.BillingDetails.SaleAmountDetails.Amount value
invalid
PurchaseDetails.BillingDetails.SaleAmountDetails.CurrencyCode
value invalid
PurchaseDetails.SuccessURL and PurchaseDetails.FailureURL need
to be provided
PurchaseDetails.SuccessURL value is invalid
PurchaseDetails.FailureURL value is invalid
UKashItem.TransactionId must contain _
PurchaseDetails.AccountDetails.CompanyId value invalid
AccountDetails.CompanyId value invalid
PurchaseDetails.AccountDetails.AccountName value invalid
AccountDetails.AccountName value invalid
PurchaseDetails.AccountDetails.AccountName not configured
AccountDetails.AccountName not configured
PurchaseDetails.AccountDetails.AccountPIN value invalid
AccountDetails.AccountPIN value invalid
PurchaseDetails.AccountDetails.AccountPIN not configured
AccountDetails.AccountPIN not configured
PurchaseDetails.TransactionId must be unique
PurchaseDetails.PaymentMethod not Active
UKashItem.TransactionId must be unique
UKashItem.PaymentMethod not Active
UKashItem.AmountDetails.CurrencyCode is not valid
PurchaseDetails.BillingDetails.AmountDetails.CurrencyCode value
invalid
Invalid
PurchaseDetails.BillingDetails.AmountDetails.CurrencyCode and
PurchaseDetails.BillingDetails.AmountDetails.Exponent
combination
PurchaseDetails.BillingDetails.SaleAmountDetails.CurrencyCode
value invalid

© 2013 DataCash. All rights reserved.
Page 15 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

026
027
030
030
030
035
200
200
201
201
202
202
203
204
205
206
207
208
209
210
211
212
213
295
296
296
297
298
299
300
301
301
302
302
302
303
303
304

Invalid
PurchaseDetails.BillingDetails.SaleAmountDetails.CurrencyCode
and PurchaseDetails.BillingDetails.SaleAmountDetails.Exponent
combination
PurchaseDetails.TransactionDateTime value invalid
PurchaseDetails.BillingDetails.AmountDetails.Exponent value
invalid
UKashItem.AmountDetails.Exponent value invalid
UKashItem.AccountNumber must be supplied
Transaction not found
AccountNumber must be supplied
AccountDetails must be supplied
AccountPIN must be supplied
AmountDetails must be supplied
UserIP must be supplied
ActionType value invalid
amountDetails.Amount value invalid
amountDetails.CurrencyCode value invalid
amountDetails.Exponent value invalid
Modification.amountDetails are invalid
Modification.amountDetails conflicts with referred transaction
Modification.DPGReferenceId refers to transaction that was
unsuccessful
Modification.DPGReferenceId refers to transaction with unknown
typeOfAction
Modification.DPGReferenceId refers to transaction that cannot be
cancelled
Modification.DPGReferenceId refers to transaction that cannot be
captured
Modification.DPGReferenceId refers to transaction that cannot be
refunded
Modification.amountDetails.Amount exceeds the limit that it can
refund for
EndDate must be formatted correctly: mm/dd/yyyy
Frequency must be sent
StartDate must be formatted correctly: mm/dd/yyyy
StartDate must be sent
Recurring transactions can only be used with Authorise and
Capture
First 8 digits of TransactionID must be unique
AccountNumber must be supplied
RoutingNumber must be supplied
FinancialAccountNumber must be supplied
BillingDetails.AddressDetails must be supplied
Currency Conversion Error::Invalid exchange rate retrieved
Currency Conversion Error::Failed to retrieve rate version
BillingDetails.AddressDetails.StreetLine1 must be supplied
Currency Conversion::Exchange rate retrieved was older than 4
days
BillingDetails.AddressDetails.City must be supplied

© 2013 DataCash. All rights reserved.
Page 16 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

305
306
307
308
309
310
310
311
312
313
313
313
314
314
315
315
316
317
317
318
319
320
321
322
323
323
324
324
325
326
400
401
402
403
404
405
406
407
408
409
411
441
443
445
451

BillingDetails.AddressDetails.StateProvince must be supplied
BillingDetails.AddressDetails.Country must be supplied
BillingDetails.AddressDetails.PostalCode must be supplied
PersonalDetails.SSN must be supplied
PersonalDetails.FirstName must be supplied
AccountNumber must be supplied
PersonalDetails.LastName must be supplied
PersonalDetails.Telephone1 must be supplied
PersonalDetails.Telephone1_AreaCode must be supplied
Failed security checks
PersonalDetails.Email must be supplied
UserIP must be supplied
Failed security checks
BillingDetails.AddressDetails.Country value invalid
Failed security checks
BillingDetails.AddressDetails.Country value invalid
FinancialAccountNumber value invalid
FinancialAccountNumber failed ABA Routing Code Checksum
AccountNumber value invalid
PersonalDetails.SSN value invalid
BillingDetails.AddressDetails.PostalCode value invalid
AccountNumber value invalid
BillingDetails.AddressDetails.StateProvince value invalid
PersonalDetails.Telephone1 value invalid
PersonalDetails.Telephone1_AreaCode value invalid
PersonalDetails.Email value invalid
PersonalDetails.FirstName value invalid
BillingDetails.AddressDetails.City value invalid
PersonalDetails.LastName value invalid
UserIP value invalid
AccountNumber must be supplied
AccountPIN must be supplied
Either SortCode and AccountNumber OR IBAN OR
PaymentReference must be supplied - no other combinations
permitted.
Either DelayDays OR DebitDate must be supplied, not both or
neither
DebitDate is not a valid date
Invalid combination of customer name and address details
PurchaseDetails.BillingDetails.Name must be supplied
Either SortCode and AccountNumber OR IBAN must be supplied no other combinations permitted.
TypeOfAction is missing or invalid.
DebitDate is in the past
SortCode must be included for giropay payment
Amazon Contract Id must be supplied
PurchaseDetails.LineItems must be supplied
PurchaseDetails.ShippingDetails must be supplied
PurchaseDetails.ShippingDetails.AmountDetails.Amount value
invalid

© 2013 DataCash. All rights reserved.
Page 17 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

452
453
449
450
455
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
600
601
602
603
604
605
606
607
607
608
609
610
610

PurchaseDetails.ShippingDetails.AmountDetails.CurrencyCode
value invalid
Invalid
PurchaseDetails.ShippingDetails.AmountDetails.CurrencyCode and
PurchaseDetails.ShippingDetails.AmountDetails.Exponent
combination
PurchaseDetails.ShippingDetails.AmountDetails.Amount plus total
line item cost must equal to billing amount
PurchaseDetails.ShippingDetails.AmountDetails.CurrencyCode
must be equal to
PurchaseDetails.BillingDetails.AmountDetails.CurrencyCode
PoliItem.FinancialInstitutionCode is invalid
BillingDetails.AddressDetails must be supplied
BillingDetails.AddressDetails.StreetLine1 must be supplied
BillingDetails.AddressDetails.City must be supplied
BillingDetails.AddressDetails.StateProvince must be supplied
BillingDetails.AddressDetails.Country must be supplied
BillingDetails.AddressDetails.PostalCode must be supplied
ShippingDetails must be supplied
ShippingDetails.AddressDetails must be supplied
ShippingDetails.AddressDetails.StreetLine1 must be supplied
ShippingDetails.AddressDetails.City must be supplied
ShippingDetails.AddressDetails.StateProvince must be supplied
ShippingDetails.AddressDetails.Country must be supplied
ShippingDetails.AddressDetails.PostalCode must be supplied
BillingDetails.AddressDetails.Country value invalid
ShippingDetails.AddressDetails.Country.Length value invalid
PersonalDetails.FirstName must be supplied
PersonalDetails.LastName must be supplied
PersonalDetails.Email must be supplied
PersonalDetails.Telephone1 must be supplied
PersonalDetails.Telephone2_CountryCode must be supplied, and
must be larger than zero
PersonalDetails.Telephone2_AreaCode must be supplied, and
must be larger than zero
PersonalDetails.Telephone2 must be supplied
UKashItem.AccountNumber must be supplied
UKashItem.AccountPIN must be supplied
UKashItem.AccountPIN must be a numeric
UkashItem.AccountPIN must be 4 digits long
UKashItem.AccountNumber must be 16 or 19 digits long
UKashItem.AccountValue must be supplied
UKashItem.TypeOfRedemption must be supplied
RetrieveConvertedAmount procedure
UKashItem.AccountNumber does not comply to the Luhn
Algorithnm
Error in Currency Conversion
OneClickItem.ServiceType is invalid
OneClickItem.ServiceType must be supplied
DBTItem.ServiceType must be supplied

© 2013 DataCash. All rights reserved.
Page 18 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

611
612
612
614
800
800
801
802
803
804
805
806
807
808
809
812
813
813
814
814
832
832
1201
1202
1203
1209
1210
1211
1212
9007
9999
9999
15295

DBTItem.CurrencyCode must be supplied
DBTItem.FirstName must be supplied
DBTItem.LastName must be supplied
GetRateVersion procedure::Could not retrieve rate version
AccountNumber must be supplied
DBTItem.AccountNumber must be supplied
Could not connect to the processor - the operation has timed-out
PurchaseDetails.PersonalDetails.FirstName is invalid
PurchaseDetails.PersonalDetails.LastName is invalid
PurchaseDetails.BillingDetails.PostalCode is invalid
PurchaseDetails.BillingDetails.PostalCode length is invalid
PurchaseDetails.BillingDetails.StateProvince length is invalid
PurchaseDetails.BillingDetails.StateProvince is invalid
PurchaseDetails.BillingDetails.Country is invalid
PurchaseDetails.CustomerReference must be supplied
The InstaDebit notification is invalid
ExperCashPaymentStatusItem.StartDate is not valid
iDealPaymentStatusItem.StartDate is not valid
ExperCashPaymentStatusItem.EndDate is not valid
iDealPaymentStatusItem.EndDate is not valid
PurchaseDetails.TransactionId value contains invalid characters
PayoutDetails.TransactionId value contains invalid characters
AliPayItem.Subject must be supplied
AliPayItem.AuthorizationToken must be supplied
AliPayItem.BuyerId must be supplied
Only REFUND modifications are supported for AliPay
Refund amount does not match original transaction amount
Refund currency does not match original transaction currency
Refund currency exponent does not match original transaction
exponent
No Valid Protocols for PayMethod, Merchant, and Currency
No OrderID
Internal System Error
Digest key not correct. Message could have been tampered with

© 2013 DataCash. All rights reserved.
Page 19 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

2.7

APPENDIX 7 – APG PROCESSOR / PAYMENT METHOD TYPES

Payment Method
Type

Description

A7

AliPay

AM

Amazon

BT

BU

Full Description

Checkout by Amazon is a complete checkout and
payment solution for ecommerce retailers. You can
offer it as a checkout or payment option on your retail
website to enable millions of Amazon customers to
use information stored in their Amazon.com accounts
to buy on your site. Your customers use shipping
addresses and payment methods stored in their
Amazon.com accounts to checkout on your website.
Direct Bank Direct Bank Transfer (DBT) is a non real-time bank
Transfer
wire solution whereby users can make a local bank
deposit from their personal bank accounts via online
banking, telephone banking or in person over-thecounter. DataCash provides a list of current DBT
supported countries to the merchant after which the
merchant can request banking details for a particular
country. The user would then use these details to
make a local bank deposit and once the deposit had
been made, the merchant would be notified by
DataCash.
ClickandBuy ClickandBuy is an e-wallet solution that allows
account users to transfer funds and make real-time
payments online. Merchants are also able to transfer
monies to the e-wallet account.
Funding of the wallet is dependent on the user’s
country of residence. A user is able to make a
purchase with his/her ClickandBuy account for a value
in excess of his/her ClickandBuy account balance.
The surplus amount is funded with the preferred
method of payment registered to the user’s account;
ClickandBuy do not return a reference to the funding
method used.
ClickandBuy do not return any error messaging in the
event of a declined transaction.
Client Registration Site –
http://www.clickandbuy.com/WW_en/home.html

© 2013 DataCash. All rights reserved.
Page 20 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

CL

Click2Pay

EL

ElectronicChe Electronic Check Processing, commonly referred to as
ck
eCheck is a popular electronic
payment solution in the US and Canada designed to
streamline payments. ECheck
payments directly debit a consumer’s bank account in
respect of goods and/or services.
eNETS
eNETS, a wholly owned subsidiary of NETS, is an
online payment gateway in Singapore. eNETS
processes both credit card and direct debit
transactions from bank accounts in Singapore and
China.
ExperCash
In Germany the ELV system (Elektronisches
Lastschriftverfahren) is the most popular method of
payment among customers in an online environment.
Approximately 45% of end customers prefer this form
of payment. The ELV process is a simple one and can
be utilised by anyone who is in possession of a
German cheque account. The customer supplies his or
her bank account details to you as the Merchant and,
based on these details, the amount payable is debited
from the customer’s bank account.
iDeal
Product offered by several large Dutch banks which
allows customers to make near-instant transfers to
merchants. The users validate themselves at their
banks’ website to complete the transaction.
InstaDebit
INSTADEBIT Services Inc. provides such a transaction
platform to merchants with competitive pricing and
near-zero charge-back, by partnering with major
industry players and employing cutting edge risk
management technology. Users are able to access
funds from their bank accounts and transfer to
merchants instantly.

EN

EV

I3

IN

CLICK2PAY is an e-wallet solution that allows account
users to transfer funds and make real-time payments
online. Merchants are also able to transfer monies to
the e-wallet account.
Funding of the wallet is dependent on the user’s
country of residence, but includes Credit Card, Debit
Card, Direct Debit/ACH, Bank Deposit and Bank Wire.
A user is able to make a purchase with his/her
CLICK2PAY account for a value in excess of his/her
CLICK2PAY account balance. The surplus amount is
taken from the auto-funding account that the user
specified at time of account registration CLICK2PAY
returns a reference to the funding method used,
where Credit Card includes credit cards and selected
debit cards; and Bank Transfer includes Direct Debit
and ACH.
Client Registration Site –
https://click2pay.wirecard.com/click2pay/user_registr
ation.c2p

© 2013 DataCash. All rights reserved.
Page 21 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

MB

Moneybooker Moneybookers is a web based wallet which allows
s
customers worldwide to make instant purchases on
the Internet. It is a fast, easy and secure way to
make deposits and withdrawals with online merchants
and is an excellent alternative to credit cards.
Funding of the wallet is dependent on the user’s
country of residence.
Client Registration Site –
https://www.moneybookers.com/app/register.pl

NT

Neteller

O3

Offline Bank
Transfer

OC

OneClick

P5

POLi

NETELLER is an e-wallet solution enabling funding and
transfer (to/from merchant) of funds. Funding
options available are dependant on the consumer’s
geographical location.
instaCASH is an instant electronic transfer available to
US and Canadian residents. How it works is that a
consumer enters the last 4 digits of their bank
account registered with NETELLER, if there are
insufficient funds in the consumer’s NETELLER account
to cover the transfer, funds will be pulled from the
bank account.
The NETELLER ATM Card is accepted worldwide and is
a convenient form of withdrawal for clients.
Client Registration Site –
https://www.NETELLER.com/signup/index.jsf

Envoy Services Ltd is a UK incorporated payment
technology and service provider for the corporate
sector. Envoy provides services to both online and
offline companies requiring localized and low cost bill
collect ion and payment execution on a cross border
basis.
POLi™ is an online payment service that enables
customers to safely pay registered online
merchants directly from their own internet banking
facility. Using a secure client-side application,
POLi™ guides a user through the internet banking
transaction process and notifies the merchant
when a transaction is completed.

© 2013 DataCash. All rights reserved.
Page 22 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

PF

UK

W3

PaySafeCard Paysafecard is a prepaid card solution. It can be used
as payment at a variety of online stores. The prepaid
card can be purchased at various retail outlets (e.g.
tobacco shops, filling stations) as well as online. The
cards are sold in fixed denominations e.g. 10, 25, 50,
etc in different currencies. Paysafecard is different
from other wallet solutions in that the consumer does
not hold an account at Paysafecard.
During the purchase process, the consumer is
redirected to the Paysafecard website to enter in their
16-digit PIN number. This is a unique number relating
to the card that was purchased. It can be found on
the card.
The user can enter up to 10 different PIN numbers for
one purchase. The cards can be of varying currencies.
Paysafecard will do the necessary currency conversion
to sum up the values of the cards entered to
determine whether there is a sufficient amount to
complete the purchase.
If there is a sufficient amount, the user will be
redirected to a second Paysafecard page where the
user will be asked to confirm the transaction and be
shown the balance remaining on the card(s) entered.
The cards will be used up in the order entered and the
last card will hold any remaining credit.
If there is an insufficient amount to complete the
purchase, the user will be informed that there are
insufficient funds and be given the opportunity to
enter more cards. The user will not be redirected back
to the merchant until he has entered valid PIN
numbers for the sufficient amount.
Ukash
Ukash is a voucher based payment method available
at any store displaying the PayPoint, PayZone or epay signs across Europe. The 19-digit Ukash Voucher
number may then be used at any online store
supporting the Ukash payment method.
WebMoney

Webmoney is a service that allows cutomers to pay
for online purchases in real time directly from their
bank account via a cash deposit at a regulated outlet
or using a pre-paid card.

© 2013 DataCash. All rights reserved.
Page 23 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

2.8

APPENDIX 8 – STATE / PROVINCE / COUNTRY CODE LIST
Country

United States

Description
Alabama
Alaska
Arizona
Arkansas
California
Colorado
Connecticut
Delaware
District of Columbia
Florida
Georgia
Hawaii
Idaho
Illinois
Indiana
Iowa
Kansas
Kentucky
Louisiana
Maine
Maryland
Massachusetts
Michigan
Minnesota
Mississippi
Missouri
Montana
Nebraska
Nevada
New Hampshire
New Jersey
New Mexico
New York
North Carolina
North Dakota
Ohio
Oklahoma
Oregon
Pennsylvania
Rhode Island
South Carolina
South Dakota
Tennessee
Texas
Utah

Code
AL
AK
AZ
AR
CA
CO
CT
DE
DC
FL
GA
HI
ID
IL
IN
IA
KS
KY
LA
ME
MD
MA
MI
MN
MS
MO
MT
NE
NV
NH
NJ
NM
NY
NC
ND
OH
OK
OR
PA
RI
SC
SD
TN
TX
UT

© 2013 DataCash. All rights reserved.
Page 24 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

Vermont
Virginia
Washington
West Virginia
Wisconsin
Wyoming
Canada
International
Puerto Rico
U.S. Virgin Islands
Northern Mariana Is.
Guam
American Samoa
Pal au
Armed Forces Americas
Armed Forces Europe
Armed Forces Pacific
United States Federal

VT
VA
WA
WV
WI
WY
CN
IT
PR
VI
MP
GU
AS
PW
AA
AE
AP
US

Alberta
British Columbia
Manitoba
New Brunswick
Newfoundland
Nova Scotia
Northwest Territories
Nunavut
Ontario
Prince Edward Island
Quebec
Saskatchewan
Yukon

AB
BC
MB
NB
NF
NS
NT
NU
ON
PE
QC
SK
YT

United Kingdom

England
Northern Ireland
Scotland
Wales

EN
NO
SC
WA

Ireland

Clare
Cork
Cavan
Carlow
Donegal
Dublin
Galway
Kildare
Kilkenny
Kerry

CE
CK
CN
CW
DL
DN
GY
KE
KK
KY

Canada

© 2013 DataCash. All rights reserved.
Page 25 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

China

Longford
Louth
Limerick
Leitrim
Laois
Meath
Monaghan
Mayo
Offaly
Roscommon
Sligo
Tipperary
Waterford
Westmeath
Wicklow
Wexford

LD
LH
LK
LM
LS
MH
MN
MO
OY
RN
SO
TY
WD
WH
WW
WX

Beijing
Tianjin
Hebei
Shanxi
Nei Mongol
Liaoning
Jilin
Heilongjiang
Shanghai
Jiangsu
Zhejiang
Anhui
Fujian
Jiangxi
Shandong
Henan
Hubei
Hunan
Guangdong
Guangxi
Hainan
Sichuan
Guizhou
Yunnan
Xizang Zìzhìqu (Tibet)
Shaanxi
Gansu
Qinghai
Ningxia
Xinjiang
Taiwan

Beijing
Tianjin
Hebei
Shanxi
Nei Mongol
Liaoning
Jilin
Heilongjiang
Shanghai
Jiangsu
Zhejiang
Anhui
Fujian
Jiangxi
Shandong
Henan
Hubei
Hunan
Guangdong
Guangxi
Hainan
Sichuan
Guizhou
Yunnan
Xizang Zìzhìqu (Tibet)
Shaanxi
Gansu
Qinghai
Ningxia
Xinjiang
Taiwan

© 2013 DataCash. All rights reserved.
Page 26 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

Xianggang (Hong Kong)
Aomen (Macao)
Chongqìng
Gaoxiong
Taibei

2.9

Xianggang (Hong Kong)
Aomen (Macao)
Chongqìng
Gaoxiong
Taibei

APPENDIX 9 – COUNTRY CODE LIST

Afghanistan
Albania
Algeria

Description

Code
AF
AL
DZ

American Samoa
Andorra
Angola
Anguilla
Antarctica
Antigua and Barbuda

AS
AD
AO
AI
AQ
AG

Argentina
Armenia
Aruba
Australia
Austria
Azerbaijan

AR
AM
AW
AU
AT
AZ

Bahamas
Bahrain
Bangladesh
Barbados
Belarus
Belgium

BS
BH
BD
BB
BY
BE

Belize
Benin
Bermuda
Bhutan
Bolivia
Bosnia and Herzegovina

BZ
BJ
BM
BT
BO
BA

Botswana
Bouvet Island
Brazil
British Indian Ocean Territory
Brunei Darussalam
Bulgaria

BW
BV
BR
IO
BN
BG

Burkina Faso
Burundi

BF
BI

© 2013 DataCash. All rights reserved.
Page 27 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

Cambodia
Cameroon
Canada
Cape Verde
Cayman Islands

KH
CM
CA
CV
KY

Central African Republic
Chad
Chile
China
Christmas Island
Cocos (Keeling) Islands

CF
TD
CL
CN
CX
CC

Colombia
Comoros
Congo
Cook Islands
Costa Rica
Côte D’Ivoire

CO
KM
CG
CK
CR
CI

Croatia
Cuba
Cyprus
Czech Republic
Denmark
Djibouti

HR
CU
CY
CZ
DK
DJ

Dominica
Dominican Republic
East Timor
Ecuador
Egypt
El Salvador

DM
DO
TP
EC
EG
SV

Equatorial Guinea
Eritrea
Estonia
Ethiopia
Falkland Islands
Faroe Islands

GQ
ER
EE
ET
FK
FO

Fiji
Finland
France
Metropolitan France
French Guiana
French Polynesia

FJ
FI
FR
FX
GF
PF

French Southern Territories
Gabon

TF
GA

© 2013 DataCash. All rights reserved.
Page 28 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

Gambia
Georgia
Germany
Ghana
Gibraltar

GM
GE
DE
GH
GI

Greece
Greenland
Grenada
Guadeloupe
Guam
Guatemala

GR
GL
GD
GP
GU
GT

Guinea
Guinea-Bissau
Guyana
Haiti
Heard and McDonald Islands
Honduras

GN
GW
GY
HT
HM
HN

Hong Kong
Hungary
Iceland
India
Indonesia
Iran (Islamic Republic of)

HK
HU
IS
IN
ID
IR

Iraq
Ireland
Israel
Italy
Jamaica
Japan

IQ
IE
IL
IT
JM
JP

Jordan
Kazakhstan
Kenya
Kiribati
Korea, Democratic People’s Republic of
Korea, Republic of

JO
KZ
KE
KI
KP
KR

Kuwait
Kyrgyzstan
Lao People’s Democratic Republic
Latvia
Lebanon
Lesotho

KW
KG
LA
LV
LB
LS

Liberia
Libyan Arab Jamahiriya

LR
LY

© 2013 DataCash. All rights reserved.
Page 29 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

Liechtenstein
Lithuania
Luxembourg
Macau
Macedonia, the former Yugoslav Republic of

LI
LT
LU
MO
MK

Madagascar
Malawi
Malaysia
Maldives
Mali
Malta

MG
MW
MY
MV
ML
MT

Marshall Islands
Martinique
Mauritania
Mauritius
Mayotte
Mexico

MH
MQ
MR
MU
YT
MX

Micronesia, Federated States of
Moldova, Republic of
Monaco
Mongolia
Montserrat
Morocco

FM
MD
MC
MN
MS
MA

Mozambique
Myanmar
Namibia
Nauru
Nepal
The Netherlands

MZ
MM
NA
NR
NP
NL

New Caledonia
New Zealand
Nicaragua
Niger
Nigeria
Niue

NC
NZ
NI
NE
NG
NU

Norfolk Island
Northern Mariana Islands
Norway
Oman
Pakistan
Pal au

NF
MP
NO
OM
PK
PW

Panama
Papua New Guinea

PA
PG

© 2013 DataCash. All rights reserved.
Page 30 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

Paraguay
Peru
Philippines
Pitcairn
Poland

PY
PE
PH
PN
PL

Portugal
Puerto Rico
Qatar
Reunion
Romania
Russian Federation

PT
PR
QA
RE
RO
RU

Rwanda
Saint Kitts and Nevis
Saint Lucia
Saint Vincent and the Grenadines
Samoa
San Marino

RW
KN
LC
VC
WS
SM

Sao Tome and Principe
Saudi Arabia
Senegal
Seychelles
Sierra Leone
Singapore

ST
SA
SN
SC
SL
SG

Slovakia (Slovak Republic)
Slovenia
Solomon Islands
Somalia
South Africa
Spain

SK
SI
SB
SO
ZA
ES

Sri Lanka
St. Helena
St. Pierre and Miquelon
Sudan
Suriname
Svalbard and Jan Mayen Islands

LK
SH
PM
SD
SR
SJ

Swaziland
Sweden
Switzerland
Syrian Arab Republic
Taiwan
Tajikistan

SZ
SE
CH
SY
TW
TJ

Tanzania, United Republic of
Thailand

TZ
TH

© 2013 DataCash. All rights reserved.
Page 31 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

Togo
Tokelau
Tonga
Trinidad and Tobago
Tunisia

TG
TK
TO
TT
TN

Turkey
Turkmenistan
Turks and Caicos Islands
Tuvalu
Uganda
Ukraine

TR
TM
TC
TV
UG
UA

United Arab Emirates
United Kingdom
United States
United States Minor Outlying Islands
Uruguay
Uzbekistan

AE
GB
US
UM
UY
UZ

Vanuatu
Vatican City State (Holy See)
Venezuela
Vietnam
Virgin Islands (British)
Virgin Islands (U.S.)

VU
VA
VE
VN
VG
VI

Wallis and Futuna Islands
Western Sahara
Yemen
Yugoslavia
Zaire
Zambia

WF
EH
YE
YU
ZR
ZM

Zimbabwe

ZW

© 2013 DataCash. All rights reserved.
Page 32 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

2.10 APPENDIX 10 – ISO CURRENCY CODES AND EXPONENTS
Alpha
Code
AED
AFA
AFN
ALL
AMD
ANG
AOA
AOK
ARS
ATS
AUD
AWG
AZN
BAM
BBD
BDT
BEF
BGL
BGN
BHD
BIF
BMD
BND
BOB

Numeric
Code

Exponent

Currency

Entity
United Arab Emirates
Afghanistan
Afghanistan
Albania
Armenia
Netherlands Antilles
Angola
Angola
Argentina
Austria
Australia
Aruba
Azerbaijan
Bosnia & Herzegovina
Barbados
Bangladesh
Belgium
Bulgaria
Bulgaria
Bahrain
Burundi
Burmuda
Brunei
Bolivia, Plurinational State
Of
Bolivia, Plurinational State
Of
Brazil
Brazil
Bahamas
Bhutan
Burma
Botswana
Belarus
Belize
Canada
Congo, The Democratic
Republic Of
Switzerland
Chile
Colombia
Costa Rica
Czechoslovakia
Cuba
Cape Verde
Cyprus

784
4
971
8
51
532
973
24
32
40
36
533
944
977
52
50
56
100
975
48
108
60
96
68

2
2
2
2
2
2
2

2
3
0
2
2
2

UAE Dirham
Afghani
Afghani
Lek
Armenian Dram
Antillian Guilder
Kwanza
Kwanza
Argentine Peso
Schilling
Australian Dollar
Aruban Guilder
Azerbaijanian Manat
Convertible Mark
Barbados Dollar
Taka
Belgian Franc
Lev
Bulgarian Lev
Bahraini Dinar
Burundi Franc
Bermudian Dollar
Brunei Dollar
Boliviano

BOV

984

2

Mvdol

BRC
BRL
BSD
BTN
BUK
BWP
BYR
BZD
CAD
CDF

76
986
44
64
104
72
974
84
124
976

2
2
2
2
2
0
2
2
2

Cruzeiro
Brazilian Real
Bahamian Dollar
Ngultrum
Kyat
Pula
Belarussian Ruble
Belize Dollar
Canadian Dollar
Congolese Franc

CHF
CLP
COP
CRC
CSK
CUP
CVE
CYP

756
152
170
188
200
192
132
196

2
2
2
2
2
2
2

2
0
2
2
2
2
2

Swiss Franc
Chilean Peso
Colombian Peso
Costa Rican Colon
Koruna
Cuban Peso
Cape Verde Escudo
Cyprus Pound

© 2013 DataCash. All rights reserved.
Page 33 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

CZK
DDM

203
278

DEM

280

DJF
DKK
DOP
DZD
ECS
EEK
EGP
ERN
ESP
ETB
EUR
FIM
FJD
FKP

262
208
214
12
218
233
818
232
724
230
978
246
242
238

FRF
GBP
GEL
GHC
GHS
GIP
GMD
GNS
GQE
GRD
GTQ
GWP
GYD
HKD
HNL
HRK
HTG
HUF
IEP
ILS
INR
IQD
IRR
ISK
ITL
JMD
JOD
JPY
KES

250
826
981
288
936
292
270
324
226
300
320
624
328
344
340
191
332
348
372
376
356
368
364
352
380
388
400
392
404

2

Krona
Mark der DDR
Deutsche Mark

0
2
2
2
2
2
2
2
2
2
2
2

2
2
2
2
2
2
0

2
2
2
2
2
2
2
2
2
2
3
2
0
2
3
0
2

Djibouti Franc
Danish Krone
Dominican Peso
Algerian Dinar
Sucre
Koruna
Egyptian Pound
Nakfa
Spanish Peseta
Ethiopian Birr
Euro
Markka
Fiji Dollar
Falkland Islands Pound
French Franc
Pound Sterling
Lari
Cedi
Cedi
Gibraltar Pound
Dalasi
Guinea Franc
Ekwele
Drachma
Quetzal
Guinea-Bissau Peso
Guyana Dollar
Hong Kong Dollar
Lempira
Croatian Kuna
Gourde
Forint
Irish Pound
New Israeli Sheqel
Indian Rupee
Iraqi Dinar
Iranian Rial
Iceland Krona
Lira
Jamaican Dollar
Jordanian dinar
Yen
Kenyan Shilling

Czech
German Democratic
Republic
Germany, Federal
Republic of
Djibouti
Denmark
Dominican Republic
Algeria
Ecuador
Estonia
Egypt
Eritrea
Spain
Ethiopia
European Union
Finland
Fiji
Falkland Islands
(Malvinas)
France
United Kingdom
Georgia
Ghana
Ghana
Gibraltar
Gambia
Guinea
Equatorial Guinea
Greece
Guatemala
Guinea-Bissau
Guyana
Hong Kong
Honduras
Croatia
Haiti
Hungary
Ireland
Israel
India
Iraq
Iran
Iceland
Italy
Jamaica
Jordan
Japan
Kenya

© 2013 DataCash. All rights reserved.
Page 34 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

KGS
KHR
KMF
KPW

417
116
174
408

2
2
0
2

Som
Riel
Comoro Franc
North Korean Won

KRW
KWD
KYD
KZT
LAK

410
414
136
398
418

0
3
2
2
2

Won
Kuwaiti Dinar
Cayman Islands Dollar
Tenge
Kip

LBP
LKR
LRD
LSM
LTL
LUF
LVL
LYD
MAD
MDL
MGF
MKD

422
144
430
426
440
442
428
434
504
498
450
807

2
2
2
2
2

Lebanese Pound
Sri Lanka Rupee
Liberian Dollar
Loti
Lithuanian Litas
Luxembourg Franc
Latvian Lats
Libyan Dinar
Moroccan Dirham
Moldovan Leu
Malagasy Franc
Denar

MLF
MNT
MOP
MRO
MTP
MUR
MVR
MWK
MXN
MYR
MZM
MZN
NAD
NGN
NIC
NLG
NOK
NPR
NZD
OMR
PAB
PES
PGK
PHP
PKR

466
496
446
478
470
480
462
454
484
458
508
943
516
566
558
528
578
524
554
512
590
604
598
608
586

2
3
2
2
0
2

2
2
2
2
2
2
2
2
2
2
2
2
2
2
2
2
2
3
2
2
2
2
2

Mali Franc
Tugrik
Pataca
Ouguiya
Maltese Pound
Mauritius Rupee
Rufiyaa
Kwacha
Mexican Peso
Malaysian Ringgit
Metical
Metical
Namibia Dollar
Naira
Cordoba Oro
Netherlands Guilder
Norwegian Krone
Nepalese Rupee
New Zealand Dollar
Rial Omani
Balboa
Nuevo Sol
Kina
Philippine Peso
Pakistan Rupee

Kyrgyzstan
Kampuchea, Democratic
Comoros
Korea, Democratic
People's of
Korea, Republic of
Kuwait
Cayman Islands
Kazakhstan
Lao People's Democratic
Republic
Lebanon
Sri Lanka
Liberia
Lesotho
Lithuania
Luxembourg
Latvia
Libyan Arab Jamahiriya
Morocco
Moldova, Republic Of
Madagascar
Macedonia, The Former
Yugoslav Republic Of
Mali
Mongolia
Macau
Mauritania
Malta
Mauritius
Maldives
Malawi
Mexico
Malaysia
Mozambique
Mozambique
Namibia
Nigeria
Nicaragua
Netherlands
Norway
Nepal
New Zealand
Oman
Panama
Peru
Papau New Guinea
Philippines
Pakistan

© 2013 DataCash. All rights reserved.
Page 35 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

PLN
PLZ
PTE
PYG
QAR
RMB
ROL
RON
RSD
RUB
RWF
SAR
SBD
SCR
SDG
SDP
SEK
SGD
SHP

985
616
620
600
634
156
642
946
941
643
646
682
90
690
938
736
752
702
654

2
2

SKK
SLL
SOS
SRG
STD
SUR

703
694
706
740
678
810

SVC
SYP
SZL
THB
TJS
TMT
TND
TOP
TPE
TRL
TRY
TTD

222
760
748
764
972
934
788
776
626
792
949
780

2
2
2
2
2
2
3
2
2
0
2
2

TWD
TZS

901
834

2
2

UAH
UGX
USD
USN
USS
UYP

980
800
840
997
998
858

2
2
2

0
2
2
0
2
2
2
0
2
2
2
2
2
2
2
2

2
2
2

2

Zloty
Zloty
Portuguese Escudo
Guarani
Qatari Rial
Yuan Renminbi
Leu
Leu
Serbian Dinar
Russian Ruble
Rwanda Franc
Saudi Riyal
Solomon Islands Dollar
Seychelles Rupee
Sudanese Pound
Sudanese Pound
Swedish Krona
Singapore Dollar
Saint Helena Pound
Koruna
Leone
Somali Shilling
Suriname Guilder
Dobra
Rouble
El Salvador Colon
Syrian Pound
Lilangeni
Baht
Somoni
New Manat
Tunisian Dinar
Pa'anga
Timor Escudo
Turkish Lira
Turkish Lira
Trinidad and Tobago
Dollar
New Taiwan Dollar
Tanzanian Shilling
Hryvnia
Uganda Shilling
US Dollar
US Dollar (Next day)
US Dollar (same day)
Peso Uruguayo

Poland
Poland
Portugal
Paraguay
Qatar
China
Romania
Romania
Serbia
Russian Federation
Rwanda
Saudi Arabia
Solomon Islands
Seychelles
Sudan
Sudan
Sweden
Singapore
Saint Helena, Ascension
And Tristan Da Cunha
Slovak
Sierra Leone
Somalia
Suriname
Sao Tome and Principe
Union of Soviet Socialist
Republics
El Salvador
Syrian Arab Republic
Swaziland
Thailand
Tajikistan
Turkmenistan
Tunisia
Tonga
East Timor
Turkey
Turkey
Trinidad and Tobago
Taiwan, Province of China
Tanzania, United Republic
of
Ukraine
Uganda
United States
United States
United States
Uruguay

© 2013 DataCash. All rights reserved.
Page 36 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

UZS
VEB
VEF

860
862
937

2
2
2

Uzbekistan Sum
Bolivar
Bolivar Fuerte

VND
VUV
WST
XAF

704
548
882
950

0
0
2
0

Dong
Vatu
Tala
CFA Franc BEAC

XCD
XDR

951
960

2

East Caribbean Dollar
Special Drawing Rights

XEU

954

XOF

952

0

CFA Franc BCEAO

XPF
YDD
YER
YUD
ZAR
ZMK
ZRZ
ZWD
ZWL

953
720
886
890
710
894
180
716
932

0

CFP Franc
Yemeni Dinar
Yemeni Rial
New Yugoslavian Dinar
Rand
Zambian Kwacha
Zaire
Zimbabwe Dollar
Zimbabwe Dollar

European Currency Unit

2
2
2
2
2
2

Uzbekistan
Venezuela
Venezuela, Bolivarian
Republic Of
Viet Nam
Vanuatu
Samoa
Cameroon, Central African
Republic, Chad, Congo ,G
Antigua
International Monetary
Fund
Euro. Monetary
Cooperation Fund (EMCF)
Benin, Ivory coast, Niger,
Senegal, Togo, Upper Vo
French Polynesia
Yemen, Democratic
Yemen
Yugoslavia
South Africa
Zambia
Zaire
Zimbabwe
Zimbabwe

2.11 APPENDIX 11 – IDS REQUIRED PER COUNTRY
Country
Afghanistan

Country
Type of ID Number Required
Code
AF
Passport Registry Number

Albania

AL

Passport Registry Number

Algeria

DZ

Passport Registry Number

American Samoa

AS

Passport Registry Number

Andorra

AD

Passport Registry Number

Angola

AO

Passport Registry Number

Anguilla

AI

Passport Registry Number

Antigua and Barbuda

AG

Passport Registry Number

Argentina

AR

Passport Registry Number

Armenia

AM

Passport Registry Number

Aruba

AW

Passport Registry Number

© 2013 DataCash. All rights reserved.
Page 37 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

Australia

AU

Passport Registry Number

Austria

AT

Passport Registry Number

Azerbaijan

AZ

Passport Registry Number

Bahamas

BS

Passport Registry Number

Bahrain

BH

Passport Registry Number or Personal
Identification Number

Bangladesh

BD

Passport Registry Number

Barbados

BB

Passport Registry Number

Belarus

BY

Passport Registry Number or Personal
Identification Number

Belgium

BE

Passport Registry Number

Bermuda

BM

Passport Registry Number

Bolivia

BO

Passport Registry Number

Bosnia and Herzegovina

BA

Passport Registry Number or Personal
Identification Number

Botswana

BW

Passport Registry Number

Brazil

BR

Passport Registry Number

Bulgaria

BG

Passport Registry Number or Personal
Identification Number

Burkina Faso

BF

Passport Registry Number

Burundi

BI

Passport Registry Number

Cambodia

KH

Passport Registry Number

Cameroon

CM

Passport Registry Number

Canada - (5 out of 12 prov)
Manitoba, Newfoundland, Nova
Scotia, Ontario, Quebec
Canada

CA

Driver's License Number

CA

Passport Registry Number

Cape Verde

CV

Passport Registry Number

Cayman Islands

KY

Passport Registry Number

Chile

CL

Passport Registry Number

China

CN

Passport Registry Number or Personal
Identification Number

Christmas Island

CX

Passport Registry Number

Cocos (Keeling) Islands

CC

Passport Registry Number

Colombia

CO

Passport Registry Number

© 2013 DataCash. All rights reserved.
Page 38 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

Cook Islands

CK

Passport Registry Number

Costa Rica

CR

Passport Registry Number

Cote d'Ivoire/Ivory Coast

CI

Passport Registry Number

Croatia

HR

Passport Registry Number or Personal
Identification Number

Cuba

CU

Passport Registry Number

Cyprus

CY

Passport Registry Number

Czech Republic

CZ

Passport Registry Number or Personal
Identification Number

Denmark

DK

Passport Registry Number or Personal
Identification Number

Djibouti

DJ

Passport Registry Number

Dominica

DM

Passport Registry Number

Dominican Republic

DO

Passport Registry Number

Ecuador

EC

Passport Registry Number or Personal
Identification Number

Egypt

EG

Passport Registry Number

El Salvador

SV

Passport Registry Number

Equatorial Guinea

GQ

Passport Registry Number

Eritrea

ER

Passport Registry Number

Estonia

EE

Passport Registry Number

Ethiopia

ET

Passport Registry Number

Falkland Islands

FK

Passport Registry Number

Faroe Islands

FO

Passport Registry Number

Fiji

FJ

Passport Registry Number

Finland

FI

Passport Registry Number or Personal
Identification Number

France

FR

Passport Registry Number or Personal
Identification Number

French Guiana

GF

Passport Registry Number

French Polynesia

PF

Passport Registry Number

French Southern Territories

TF

Passport Registry Number

Gambia

GM

Passport Registry Number

Georgia

GE

Passport Registry Number

© 2013 DataCash. All rights reserved.
Page 39 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

Germany

DE

Passport Registry Number or Personal
Identification Number

Ghana

GH

Passport Registry Number

Gibraltar

GI

Passport Registry Number

Greece

GR

Passport Registry Number

Greenland

GL

Passport Registry Number

Guadeloupe

GP

Passport Registry Number

Guam

GU

Passport Registry Number

Guatemala

GT

Passport Registry Number or Personal
Identification Number

Guinea

GN

Passport Registry Number

Guyana

GY

Passport Registry Number

Haiti

HT

Passport Registry Number

Honduras

HN

Passport Registry Number

Hong Kong (China)

HK

Passport Registry Number

Hungary

HU

Passport Registry Number

Iceland

IS

Passport Registry Number or Personal
Identification Number

India

IN

Passport Registry Number

Indonesia

ID

Passport Registry Number or Personal
Identification Number

Iran

IR

Passport Registry Number

Iraq

IQ

Passport Registry Number

Ireland

IE

Passport Registry Number

Isle of Man

IM

Passport Registry Number

Israel

IL

Passport Registry Number

Italy

IT

Passport Registry Number

Jamaica

JM

Passport Registry Number

Japan

JP

Passport Registry Number

Jordon

JO

Passport Registry Number or Personal
Identification Number

Kazakhstan

KZ

Passport Registry Number

Kenya

KE

Passport Registry Number

© 2013 DataCash. All rights reserved.
Page 40 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

Kiribati

KI

Passport Registry Number

Korea, South

KR

Passport Registry Number or Personal
Identification Number

Kuwait

KW

Passport Registry Number

Kyrgyzstan

KG

Passport Registry Number

Laos

LA

Passport Registry Number

Latvia

LV

Passport Registry Number or Personal
Identification Number

Lebanon

LB

Passport Registry Number

Lesotho

LS

Passport Registry Number or Personal
Identification Number

Liberia

LR

Passport Registry Number

Libya

LY

Passport Registry Number

Liechtenstein

LI

Passport Registry Number

Lithuania

LT

Passport Registry Number or Personal
Identification Number

Luxembourg

LU

Passport Registry Number

Macau (China)

MO

Passport Registry Number

Macedonia

MK

Passport Registry Number or Personal
Identification Number

Malawi

MW

Passport Registry Number

Malaysia

MY

Passport Registry Number or Personal
Identification Number

Maldives

MV

Passport Registry Number

Mali

ML

Passport Registry Number

Malta

MT

Passport Registry Number or Personal
Identification Number

Marshall Islands

MH

Passport Registry Number

Martinique

MQ

Passport Registry Number

Mauritania

MR

Passport Registry Number

Mauritius

MU

Passport Registry Number

Mayotte

YT

Passport Registry Number

Mexico

MX

Passport Registry Number or Registro
Federal de Contribuyentes or
Credencial de Elector

Micronesia, Federated States of

FM

Passport Registry Number

© 2013 DataCash. All rights reserved.
Page 41 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

Moldova

MD

Passport Registry Number

Monaco

MC

Passport Registry Number

Mongolia

MN

Passport Registry Number

Montserrat

MS

Passport Registry Number

Morocco

MA

Passport Registry Number

Mozambique

MZ

Passport Registry Number

Myanmar

MM

Passport Registry Number

Namibia

NA

Passport Registry Number

Nepal

NP

Passport Registry Number

Netherlands

NL

Passport Registry Number

Netherlands Antilles

AN

Passport Registry Number

New Caledonia

NC

Passport Registry Number

New Zealand

NZ

Passport Registry Number

Nicaragua

NI

Passport Registry Number or Personal
Identification Number

Niger

NE

Passport Registry Number

Nigeria

NG

Passport Registry Number

Niue

NU

Passport Registry Number

Norfolk Island

NF

Passport Registry Number

Northern Mariana Islands

MP

Passport Registry Number

Norway

NO

Passport Registry Number or Personal
Identification Number

Oman

OM

Passport Registry Number

Pakistan

PK

Passport Registry Number or Personal
Identification Number

Palau

PW

Passport Registry Number

Panama

PA

Passport Registry Number

Papua New Guinea

PG

Passport Registry Number

Peru

PE

Passport Registry Number

Philippines

PH

Passport Registry Number or Driver's
License Number

Pitcairn

PN

Passport Registry Number

© 2013 DataCash. All rights reserved.
Page 42 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

Poland

PL

Passport Registry Number or Personal
Identification Number

Portugal

PT

Passport Registry Number

Puerto Rico

PR

Passport Registry Number

Qatar

QA

Passport Registry Number

Reunion

RE

Passport Registry Number

Romania

RO

Passport Registry Number or Personal
Identification Number

Russian Federation

RU

Passport Registry Number

Saint Kitts and Nevis

KN

Passport Registry Number

Samoa

WS

Passport Registry Number

San Marino

SM

Passport Registry Number

Saudi Arabia

SA

Passport Registry Number

Senegal

SN

Passport Registry Number

Serbia and Montenegro

YU

Passport Registry Number or Personal
Identification Number

Seychelles

SC

Passport Registry Number

Sierra Leone

SL

Passport Registry Number

Singapore

SG

Passport Registry Number

Slovakia

SK

Passport Registry Number

Slovenia

SI

Passport Registry Number or Personal
Identification Number

Somalia

SO

Passport Registry Number

South Africa

ZA

Passport Registry Number or Personal
Identification Number

Spain

ES

Passport Registry Number

Sri Lanka

LK

Passport Registry Number or Personal
Identification Number

St. Helena

SH

Passport Registry Number

St. Pierre and Miquelon

PM

Passport Registry Number

Sudan

SD

Passport Registry Number

Suriname

SR

Passport Registry Number

Swaziland

SZ

Passport Registry Number

© 2013 DataCash. All rights reserved.
Page 43 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

Sweden

SE

Passport Registry Number or Personal
Identification Number

Switzerland

CH

Passport Registry Number

Syria

SY

Passport Registry Number

Taiwan

TW

Passport Registry Number

Tajikistan

TJ

Passport Registry Number

Tanzania

TZ

Passport Registry Number

Thailand

TH

Passport Registry Number

Togo

TG

Passport Registry Number

Tokelau

TK

Passport Registry Number

Trinidad and Tobago

TT

Passport Registry Number

Tunisia

TN

Passport Registry Number

Turkey

TR

Passport Registry Number

Turkmenistan

TM

Passport Registry Number

Turks and Caicos Islands

TC

Passport Registry Number

Uganda

UG

Passport Registry Number

Ukraine

UA

Passport Registry Number

United Arab Emirates

AE

Passport Registry Number

United Kingdom

GB

Passport Registry Number or Driver's
License Number

United States

US

Passport Registry Number or Driver's
License Number

Uruguay

UY

Passport Registry Number

Uzbekistan

UZ

Passport Registry Number

Venezuela

VE

Passport Registry Number

Vietnam

VN

Passport Registry Number

Virgin Islands

VI

Passport Registry Number

Virgin Islands (British)

VG

Passport Registry Number

Wallis and Futuna Islands

WF

Passport Registry Number

Western Sahara

EH

Passport Registry Number

Yemen

YE

Passport Registry Number

© 2013 DataCash. All rights reserved.
Page 44 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

Serbia and Montenegro

YU

Passport Registry Number or Personal
Identification Number

Zambia

ZM

Passport Registry Number

Zimbabwe

ZW

Passport Registry Number

2.12 APPENDIX 12 – APG CLIENTIDNUMBERS TYPES
ID

ID Type Description

0 Type
ID
1

None

2

Personal Identification Number

3

Identity Card Number

4

Driver's License Number

8

Travel Document

12

Residence Permit

13

Identity Certificate Number

16

Registro Federal de

17

Contribuyentes
Credencial de Elector

Passport Registry Number

2.13 APPENDIX 13 – APG LANGUAGES SUPPORTED
Language Code

Language

ar

Arabic

bg

Bulgarian

cs

Czech

cz

Czech

da

Danish

de

German

el

Greek

en

English

es

Spanish

et

Estonian

© 2013 DataCash. All rights reserved.
Page 45 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

fi

Finnish

fr

French

hu

Hungarian

it

Italian

iw

Hebrew

ja

Japanese

ko

Korean

lt

Lithuanian

lv

Latvian

nl

Dutch

no

Norwegian

pl

Polish

pt

Portuguese

pt-BR

Portuguese

pt-PT

Portuguese

ro

Romanian

ru

Russian

sk

Slovakian

sl

Slovenian

sv

Swedish

tr

Turkish

zh

Chinese

zh-Hans

Chinese Simplified

zh-Hant

Chinese Traditional

2.14 APPENDIX 14 – APG PURCHASE SOURCES AND NUMERIC CODES
Numeric Code
1
2

Purchase Source
WEB
PHONE

© 2013 DataCash. All rights reserved.
Page 46 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

2.15 APPENDIX 15 – APG REDEMPTION TYPES AND NUMERIC CODES
Numeric
Code

Redemption Type

1

CASH_WITHDRAWAL

2

ACCOUNT_DEPOSIT

3

PRODUCT_SERVICE_PURCHASE

4

ISSUE_VOUCHER

5

VOID_TRANSACTION

6

ACCOUNT_ADD

7

ACCOUNT_SUBTRACT

8

TRANSACTION_ENQUIRY

© 2013 DataCash. All rights reserved.
Page 47 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

2.16 APPENDIX 16 – MONEYBOOKERS PAYMENT METHODS
Payment option
All Credit/Debit
Cards
Visa
MasterCard
Diners
Visa Delta/Debit
Visa Electron
Maestro
Solo
Laser
CartaSi
PostePay
Giropay
Sofortüberweisung

Code

Availability

ACC

International

VSA
MSC
DIN
VSD
VSE
MAE
SLO
LSR
CSI
PSP
GIR
SFT

Online Bank Transfer

OBT

Nordea Solo Sweden
Nordea Solo Finland
iDeal
Netpay (EPS)
Enets
POLi
ELV
All Polish Banks (all
banks below)
 mBank
(mTransfer)
 Płacę z Inteligo
 Bank Nordea
Poland
 Bank Zachodni
WBK
 PKO BP (PKO
Inteligo)
 Multibank
(Multitransfer)
 Bank BPH
 ING Bank Śląski
 Lukas Bank
 Kredyt Bank
 InvestBank
 PeKaO S.A.
 Citibank
handlowy
 BGŻ
 Millenium
 Bank Ochrony
Środowiska
 Fortis Bank

EBT
SO2
IDL
NPY
ENT
PLI
DID

International
International
International
International
International
UK, Austria, Spain
United Kingdom
Ireland
Italy
Italy
Germany
Germany
Germany, United Kingdom, Denmark, Finland,
Sweden, Poland, Estonia, Latvia, Lithuania, Italy
Sweden
Finland
The Netherlands
Austria
Singapore
Australia
Germany

PWY

Poland

PWY25

Poland

PWY26

Poland

PWY32

Poland

PWY20

Poland

PWY6

Poland

PWY7

Poland

PWY15
PWY5
PWY14
PWY37
PWY17
PWY18

Poland
Poland
Poland
Poland
Poland
Poland

PWY19

Poland

PWY21
PWY22

Poland
Poland

PWY28

Poland

PWY33

Poland

© 2013 DataCash. All rights reserved.
Page 48 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL



Deutsche Bank
PBC S.A.

PWY36

Poland

2.17 APPENDIX 17 – ENVOY BANKING SERVICES
For Deposits

ABAQOOS

Consumer
Country
Hungary

Must be HUF

BANKLINK

Estonia

Must be EEK

BANKLINKNORDEA

Latvia

Must be either EUR or LVL

BANKLINKSWED
BANCO
SANTANDER
Boleto Bancário

Estonia

Must be EEK

Chile

Must be CLP

Brazil

Must be BRL

Product Option

Currency

Jordan
UAE
Bahrain
Israel
Egypt

CASHU

Canada
Italy
Kuwait
Lebanon
Malaysia
Mauritania
Morocco
Oman
Qatar
Russia
Saudi Arabia
Tanzania
Tunisia
Turkey
Ukraine
Uruguay
Venezuela

Must be USD

Mexico
DINEROMAIL

Argentina

Must be either MXN, ARS, or CLP

Chile
EKONTO

Czech Republic

Must be CZK

EPAY

Bulgaria

Must be BGN

EPS

Austria

Must be EUR

© 2013 DataCash. All rights reserved.
Page 49 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

EUTELLER

Finland

Must be EUR

EWIREDK

Denmark

Must be DKK

EWIRESE

Sweden

Must be SEK

IDEAL

Netherlands

Must be EUR

INSTANTBANK

MISTERCASH
MONETA
MULTIBANCO

NEOSURF

Sweden
Finland
Estonia
Belgium
Russia
Portugal
Belgium
France
Spain

SEK, EUR, EEK (Not Enforced by
INSTANTBANK)

Must be EUR
Must be either EUR or USD
Must be EUR

Must be EUR

Italy

Australia

Must be AUD

POLINZ

New Zealand

Must be NZD

PRZELEWY24

Poland

SOFORT

Austria
Germany
Belgium
Netherlands

POLI

Must be PLN

Must be EUR

Switzerland
SPOROPAY
TELEINGRESO

Slovakia

Must be EUR

Spain
TODITOCARD

Mexico

Must be MXN

© 2013 DataCash. All rights reserved.
Page 50 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

Russia
Ukraine
Belarus
Armenia
Azerbaijan
Ethiopia
Georgia
Kazakhstan
Lithuania
Latvia
Moldova
Uzbekistan

WEBMONEY

Must be either USD or EUR

For Payouts
Product Option
ABAQOOS
EWIRE
MONETA
WEBMONEY

Currency
HUF
DKK, SEK and NOK
USD, EUR and RUB
USD, EUR and RUB

2.18 APPENDIX 18 – APG INFORMATION SERVICE TYPE
Service Type

Value

COUNTRY_LIST

1

BANK_TRANSFER_DETAILS

2

2.19 APPENDIX 19 – ACTION TYPEID AND DESCRIPTIONS
Type ID

Description

1

Cancel

2

Capture

3

Refund

4

Buy

© 2013 DataCash. All rights reserved.
Page 51 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

5

Authorise

6

Giropay

7

Sofort

2.20 APPENDIX 20 – ECHECK MANAGED BILLING FREQUENCY PATTERN FIELDS
Field Name

Allowed Values*

Allowed Special Characters*

Day-of-Month

1-31

Month

1-12 or JAN-DEC

, - * /

Day-of-Week

1-7 or SUN-SAT

, - * / ? L #

, - * / ? L W

* Not case-sensitive
Notes on frequency pattern special characters:
 The comma (,) character is used to specify additional values. For example,
MON,WED,FRI in the Day-of-Week field means the days Monday, Wednesday,
and Friday.
 The dash (-) character is used to specify ranges. For example, 10-12 in the
Month field means the months October, November, and December.
 The asterisk (*) character is used to specify all values. For example, * in the
Month field means every month.
 The forward slash (/) character is used to specify increments. For example, 1/3
in the Day-of-Month field means every three days starting on the first day of the
month.
 The question mark (?) character is allowed for the Day-of-Month and Day-ofWeek fields. It is used to specify no specific value for the given field. This is
useful when you need to specify something in two of the fields but not the third.
See Manage Billing frequency pattern examples for clarification.
 The capital L character is allowed for the Day-of-Month and Day-of-Week fields.
This character is short-hand for last, but it has a different meaning in each of
the two fields.
o The value L in the Day-of-Month field means the last day of the month
(day 31 for January, day 28 for February on non leap years, and so on).
o If used in the Day-of-Week field by itself, it simply means 7 or SAT.
o If used in the Day-of-Week field after another value, it means the last
xxx day of the month (for example, 6L means the last Friday of the
month).
CAUTION When using the L option, do not specify lists or ranges of values, as you will
get confusing results.


The capital W character is allowed for the Day-of-Month field. This character is
used to specify the weekday (Monday-Friday) nearest the given day.
As an example, if you were to specify 15W as the value for the Day-of-Month
field, the meaning is the nearest weekday to the 15th of the month.
o If the 15th is a Saturday, the billing will occur on Friday the 14th.
o If the 15th is a Sunday, the billing will occur on Monday the 16th.

© 2013 DataCash. All rights reserved.
Page 52 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL




o If the 15th is a Tuesday, then the billing will occur on Tuesday the 15th.
However, if you specify 1W as the value for Day-of-Month and the 1st is a
Saturday, the billing will occur on Monday the 3rd, as it will not jump over the
boundary of a month’s days.
The W character can only be specified when the Day-of-Month is a single day,
not a range or list of days.
The L and W characters can also be combined for the Day-of-Month expression
to yield LW, which translates to last weekday of the month.
The number sign (#) character is allowed for the Day-of-Week field. This
character is used to specify the nth xxx day of the month.
For example, the value 6#3 means the third Friday of the month (day 6 = Friday
and #3 = the 3rd one of the month).
Other examples: 2#1 means the first Monday of the month, and 4#5 means
the fifth Wednesday of the month.

CAUTION If you specify #5 and there are not five occurrences of that day in the given

month, no billings will occur that month,
Managed Billing frequency pattern examples
Recurrence Pattern Needed

Corresponding CRON
Expression*

Weekly

Every Wednesday in the month of March

? MAR WED or
? 3 WED or
?34

Every Sunday, June through August

? JUN-AUG SUN

Every Monday

? * MON

Every 5th Monday

? */5 MON

Monthly
First day of each month

1*?

First day of every three months starting January

1 1/3 ?

First day of every other month (odd months)

1 1,3,5,7,9,11 ?

First day of every other month (even months)

1 2,4,6,8,10,12 ?

15th day of every month

15 * ?

Last day of every month

L*?

Last Friday of every month

? * 6L or
? * FRIL

Third Friday of every month

? * 6#3

Nearest weekday to the first of the month

1W * ?

Last weekday of the month

LW * ?

Yearly
© 2013 DataCash. All rights reserved.
Page 53 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

1st of January

1 JAN ?

1st weekday of January

1W JAN ?

L MAY ? or
L5?
* These are examples only—there are multiple ways to express most patterns.

Last day of May, every year

2.21 APPENDIX 21 – ECHECK ACCOUNT TYPE
Type ID

Description

1

CONSUMER_SAVING

2

CONSUMER_CHECK

3

COMMERCIAL_CHECK

2.22 APPENDIX 22 – ECHECK ACTION TYPE
Type ID

Description

1

AUTHORISE

2

AUTH_AND_CAPTURE

2.23 APPENDIX 23 - RECOMMENDED CLIENT MESSAGING
It is recommended that customers be provided with a consistent response to their
deposit request.
The response should provide the transaction number or merchant reference number for
each request, the status of the transaction e.g. accepted, declined, error and also
contact information so that the customer can contact the merchant in case of any
questions or concerns.
In the event of an accepted transaction request, the processor’s transaction id should
be provided for each confirmed request so that the customer can contact the processor
in case of any questions or concerns and may look up the transaction via the
processor’s customer interface.
Status Returned

Comment

AUTHORISED

Your transaction has been processed successfully.

INFORMATION_SUPPLIED

Your transaction has been processed successfully.

REFUSED

Your request could not be completed. Please contact
merchant customer service for more information.

© 2013 DataCash. All rights reserved.
Page 54 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

ERROR

Your request could not be completed. Please contact
merchant customer service for more information.

PENDING

Your request could not entirely be completed. Please check
your account later for an updated status. You may also
contact merchant customer service for more information.

CANCELLED

Your transaction has been cancelled as per your request.
Please contact merchant customer service for more
information.

UNKNOWN

Please note that your transaction could not be successfully
completed. Please contact our customer support helpdesk.

FRAUD_REJECTED

Your request could not be completed. Please contact
merchant customer service for more information

2.24 APPENDIX 24 – RISK SERVICES GATEWAY - STATUS CODES
Type of
Message

Status
Code
1126

RSG
Status
Codes

1127
1128
1130
1131
1133
1134
1135
1136
1137
1138
1139
1140

Status Description
RSG: rejected
RSG: review (Can be continued with “accept_review”
transaction)
Referenced transaction cannot be accepted (dc_response of
referenced transaction must be 1127)
Invalid RSG service specified
Transaction has expired and cannot be completed
The RSG service can only be used in the ecomm, cnp or
cont_auth environments
Not subscribed to RSG service
Referenced transaction not found
Fire and Forget Continuous Authority not supported with RSG
service
Historic Continuous Authority transactions are not supported
with RSG service
Other fraud screening services cannot be used in conjunction
with the RSG service
Method unsupported for RSG service
Technical Error with RSG (Can be continued with
“accept_review” transaction at merchants own risk)

2.25 APPENDIX 25 – RISK SERVICES GATEWAY - STATE/PROVINCE/COUNTY CODES
Country

Description

Code

US

Alabama

AL

Alaska

AK

© 2013 DataCash. All rights reserved.
Page 55 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

Arizona

AZ

Arkansas

AR

California

CA

Colorado

CO

Connecticut

CT

Delaware

DE

District of Columbia

DC

Florida

FL

Georgia

GA

Hawaii

HI

Idaho

ID

Illinois

IL

Indiana

IN

Iowa

IA

Kansas

KS

Kentucky

KY

Louisiana

LA

Maine

ME

Maryland

MD

Massachusetts

MA

Michigan

MI

Minnesota

MN

Mississippi

MS

Missouri

MO

Montana

MT

Nebraska

NE

Nevada

NV

New Hampshire

NH

New Jersey

NJ

New Mexico

NM

New York

NY

North Carolina

NC

North Dakota

ND

Ohio

OH

© 2013 DataCash. All rights reserved.
Page 56 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

Canada

Oklahoma

OK

Oregon

OR

Pennsylvania

PA

Rhode Island

RI

South Carolina

SC

South Dakota

SD

Tennessee

TN

Texas

TX

Utah

UT

Vermont

VT

Virginia

VA

Washington

WA

West Virginia

WV

Wisconsin

WI

Wyoming

WY

Canada

CN

International

IT

Puerto Rico

PR

U.S. Virgin Islands

VI

Northern Mariana Is.

MP

Guam

GU

American Samoa

AS

Pal au

PW

Armed Forces Americas

AA

Armed Forces Europe

AE

Armed Forces Pacific

AP

United States Federal

US

Alberta

AB

British Columbia

BC

Manitoba

MB

New Brunswick

NB

Newfoundland

NF

Nova Scotia

NS

© 2013 DataCash. All rights reserved.
Page 57 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

Northwest Territories

NT

Nunavut

NT

Ontario

ON

Prince Edward Island

PE

Quebec

QC

Saskatchewan

SK

Yukon

YT

United
Kingdom

England
Northern Ireland
Scotland
Wales

EN
NO
SC
WA

Ireland

Clare

CE

Cork

CK

Cavan

CN

Carlow

CW

Donegal

DL

Dublin

DN

Galway

GY

Kildare

KE

Kilkenny

KK

Kerry

KY

Longford

LD

Louth

LH

Limerick

LK

Leitrim

LM

Laois

LS

Meath

MH

Monaghan

MN

Mayo

MO

Offaly

OY

Roscommon

RN

Sligo

SO

Tipperary

TY

Waterford

WD

© 2013 DataCash. All rights reserved.
Page 58 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

Westmeath

WH

Wicklow

WW

Wexford

WX

2.26 APPENDIX 26 – RISK SERVICES GATEWAY - PAYMENT METHOD CODES
Code

Description

1P

1Pay

PR

Account Registration

AD

ACH Direct

AF

ACH Funding

BT

Bank transfer

CQ

Cheque

NS

Chinese Debit card

CT

Citadel Direct

CX

ClearChex

BU

Click & Buy

CL

ClickToPay

CC

Credit Card

DB

Debit Card

D1

Direct Bank Transfer

E1

EarthPort

EB

EBS

EC

ECO Card

EL

Electronic Check

EW

Electronic Wallet

EV

ELV

EP

EnsurePay

E2

EPS

EM

EverywhereMoney

FP

Firepay

G6

Giropay

GO

GlobalATM

I2

iDeal

© 2013 DataCash. All rights reserved.
Page 59 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

IN

InstaDebit

LP

Lateral Payment

LN

Lobanet

MB

Money Bookers

M1

Money Transfer

90

Navaho 900Pay

NT

NETeller

OC

OneClick

PO

Pay Out

PF

Pay Safe card

PB

PayBox

P4

PayCash

PP

PayPal

PS

Payspark

PC

PC Purse

AT

PrePaidATM

S2

Sofort

ST

StandardBankAutoPay

TS

Ticket Surf

UK

Ukash

UM

Use My Bank

UW

UseMyWallet

VP

VASpay

VB

VBucks

VC

VIP Coupon Club

© 2013 DataCash. All rights reserved.
Page 60 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.

COMPANY CONFIDENTIAL

2.27 APPENDIX 27 – OFFLINE BANK TRANSFER SERVICES
Product Option

Country

Currencies

LA_CAXIA

Spain

EUR

NORDEA_NETBANK

Denmark, Estonia,
Finland, Latvia, Lithuania

EUR, SEK, DKK

© 2013 DataCash. All rights reserved.
Page 61 of 61
This document is intended for the use of DataCash and its clients only. It contains information that is
privileged and that is the intellectual property of DataCash. You may neither copy nor use it, nor disclose it to
anyone else. If you have received this document in error, please notify DataCash immediately.



Source Exif Data:
File Type                       : PDF
File Type Extension             : pdf
MIME Type                       : application/pdf
PDF Version                     : 1.5
Linearized                      : No
Page Count                      : 65
Language                        : en-GB
Tagged PDF                      : Yes
Title                           : Draft Tokenisation Merchant Documentation
Author                          : Dave MacRae
Creator                         : Microsoft® Office Word 2007
Create Date                     : 2013:04:18 16:17:19+02:00
Modify Date                     : 2013:04:18 16:17:19+02:00
Producer                        : Microsoft® Office Word 2007
EXIF Metadata provided by EXIF.tools

Navigation menu