Terminology
The following abbreviations, acronyms and specialised terms are used in this document:
| Term | Definition |
|---|---|
| AES | Advanced Encryption Standard |
| API | Application Programming Interface |
| CBC | Cipher Block Chaining |
| ISO | International Organisation for Standardisation |
| JSON | JavaScript Object Notation |
| PKCS | Public Key Cryptographic Standards |
| PSP | Payment Service Provider |
| UTC | Co-ordinated Universal Time |
| UUID | Universally Unique Identifier |
Data type and field length
The following table lists the abbreviations used in the docs, and provides more detail about the data types:
| Term | Abbreviation | Description |
|---|---|---|
| Numeric | N | Numerals from 0 to 9 (decimal characters 48-57) |
| Alphanumeric | AN | Numeric and alphabetic characters |
| Alphanumeric Special | ANS | Alphabetic and numeric characters as well as special characters (decimal characters 32-47, 58-64, 91-96, 123-126), therefore any characters except bytes 0x00-0x31 and 0x7f-0x9f |
| Binary | BIN | Base64-encoded binary data |
| Boolean | B | Logical statement that is either TRUE or FALSE |
The following standard notation has been used (where n and n' represent positive integers):
| Description | |
|---|---|
| For fixed-length fields | n |
| For variable-length fields with a maximum | ..n |
| For variable-length fields with a minimum | n.. |
| For variable-length fields with a minimum and a maximum | n..n' |
Mandatory and optional elements
The OMC column in the message definition tables indicates whether each field is optional (O), mandatory (M) or conditional (C). Conditional fields are mandatory if specific conditions are present, otherwise they are optional.
ISO 8583 Transaction Type Codes
| Code | Transaction type | Code | Transaction type |
|---|---|---|---|
| 00 | Goods and services | 31 | Balance enquiry |
| 01 | Cash withdrawal | 32 | General enquiry |
| 02 | Debit adjustment | 33 | Offline balance enquiry |
| 03 | Cheque, guaranteed | 35 | Full statement enquiry |
| 04 | Cheque, verification | 37 | 3-D Secure authorise look-up |
| 05 | Eurocheque | 38 | Mini statement |
| 06 | Traveller's cheque | 39 | Linked account enquiry |
| 07 | Letter of credit | 40 | Cardholder accounts transfer |
| 08 | Giro | 48 | General transfer |
| 09 | Goods and services with cashback | 49 | Full-balance transfer |
| 10 | Non-cash financial instrument with transfer | 50 | Customer-generated payment |
| 11 | Quasi-cash and script | 51 | Account verification |
| 12 | Cash, manual | 52 | Payment return |
| 13 | Funds withdrawal for electronic purse, unlinked loads to funds issuer | 60 | PIN change |
| 14 | Benefits purchase with cashback | 61 | PIN verification |
| 15 | Benefits cash withdrawal | 62 | New PIN |
| 16 | Inter-account transfer debit | 63 | Unlock PIN |
| 17 | General debit | 64 | Biometric enrolment |
| 18 | Real-time clearing debit | 65 | Biometric verification |
| 19 | External transfer, debit | 70 | Card issue |
| 20 | Refund | 71 | Card delete |
| 21 | Deposit | 72 | Card replace |
| 22 | Credit adjustment | 73 | Card activate |
| 23 | Cheque deposit, guaranteed | 74 | Card deactivate |
| 24 | Cheque deposit | 75 | Card stolen |
| 26 | Initial deposit | 76 | Card lost |
| 27 | General credit | 77 | Card block |
| 28 | Billing cycle | 78 | Card dormant |
| 29 | External transfer, credit | 79 | Card damaged |
| 30 | Available balance enquiry | 91 | General administration |