5 Additional information
The following chapter will touch up on a few items that you need to keep in mind when implementing against the API.
5.1 JSON Properties
- phone: The phone property is specifically formatted. It should be in the format "+{areaCode}/{phoneNumber}". Example: "+354/6665665"
- merchantCategoryCode: The merchantCategoryCode property is a 4 digit code which represents the product/services of the company. This property is inserted into the Stores object for each of the Isos. Below is a table with a few examples.
| MCC | Description |
|---|---|
| 5013 | Motor Vehicle Supplies and New Parts |
| 5021 | Office and Commercial Furniture |
| 5039 | Construction Materials Not Elsewhere Classified |
| 5044 | Office Photographic, Photocopy and Microfilm Equipment |
| 5045 | Computers Computer Peripheral Equipment, Software |
| 5046 | Commercial Equipment Not Elsewhere Classified |
| 5047 | Dental/Laboratory/Medical/Ophthalmic Hospital Equippment and Supplies |
Note regarding card schemes
Some MCC codes support only Visa and Mastercard, but not American Express. This is due to the fact that Amex is only supported for specific markets. You can find which MCC codes are not Amex applicable by calling GET /Settings, see 3.1 General information.
- stores[i].name: The name property within the stores array is the DBA(Doing business as) value. The allowed length for this property varies between card schemes. For example, the maximum allowed length for Visa is 25 character but for Mastercard it is 22 characters.
- transactionInformation: The expectedAverageTransactionAmount and expectedMaximumTransactionAmount fields need to be posted in USD. Other currencies are not accepted.
- attachments: This property can either be a byte array or a base64 encoding of the byte array.
5.2 Supported File Types
Below is a list of supported file types when uploading files.
| File Type | Extension |
|---|---|
| Microsoft Word Document | .docx |
| Microsoft Excel Spreadsheet | .xlsx |
| Microsoft PowerPoint Presentation | .pptx |
| OpenDocument Text | .odt |
| OpenDocument Spreadsheet | .ods |
| OpenDocument Presentation | .odp |
| Portable Document Format | |
| Text Document | .txt |
| Comma-Separated Values | .csv |
| JPEG Image | .jpg or .jpeg |
| PNG Image | .png |
| TIFF Image | .tiff or .tif |
| XML Paper Specification | .xps |
| Graphics Interchange Format | .gif |
| Outlook Email Message | .msg |
| JavaScript Object Notation | .json |