Data Elements
ISO 8583 defines data elements (DEs), which are individual fields that carry the information for an authorization message. Galileo interprets and relays some of the DEs to you in various output formats. Mastercard documentation refers to these fields as DE x, whereas Visa calls them Field x. Most Visa fields use the same numbering schema as Mastercard DEs, but in some cases they do not.
- Some data elements are broken down into subelements (SE), and some subelements are further broken down into subfields (SF). In Galileo documentation the data elements are represented as DExxx with leading zeros, as necessary. For example,
DE003
andDE048
. Where there are subfields or subelements they are concatenated with the DE, and they do not have leading zeros, soDE048SF5
andDE048SE61SF3
. In the Mastercard DE column, the DEs are represented in different ways to assist with search engine hits, depending on how the search term is input. - Visa fields represent subfields as decimal numbers, such as
Field 60.10
. In Galileo documentation, only the DE is represented, unless the data element applies only to Visa transactions. In that case, the field number is provided. - Consult the documentation from each network for details on what the data elements contain.
This table shows where to see DEs that are present in authorization requests.
Field name | Mastercard DE | Visa field | Auth API | RDFs | Events API | Program API |
---|---|---|---|---|---|---|
PAN | DE2 DE 2 DE002 | 2 | pan | CARD NUMBER | protected_pan_four | |
Processing code | DE3 DE 3 DE003 | 3 | auth_type | TRANSACTION CODE/TYPE | act_type de003 | act_type |
Processing code | DE3 DE 3 DE003 | 3 | transaction_type | TRANSACTION CODE/TYPE | otype de003 | type |
Is AFT transaction | DE3 DE 3 DE003 | 3 | IS AFT TRANSACTION | |||
OTC flag | DE3 DE 3 DE003 | 3 | OTC FLAG | |||
Amount, local | DE4 DE 4 DE004 | 4 | local_currency_amount | LOCAL AMOUNT | local_currency_amount | local_amt |
Amount, transaction | DE4 DE 4 DE004 | 4 | trans_amount | TRANSACTION AMOUNT | amount | amt |
Amount, settlement | DE5 DE 5 DE005 | 5 | settle_currency_amount | SETTLE AMOUNT | settle_currency_amount | settle_amt |
Amount, billing | DE6 DE 6 DE006 | 6 | billing_currency_amount | BILLING AMOUNT | billing_amt | billing_amt |
Conversion rate, settlement | DE9 DE 9 DE009 | 9 | settle_exchange_rate | CONVERSION RATE SETTLEMENT | ||
Conversion rate, cardholder billing | DE10 DE 10 DE010 | 10 | exchange_rate | CONVERSION RATE | ||
Date, expiration | DE14 DE 14 DE014 | 14 | merchant_supplied_expiration_date | |||
Merchant category code | DE18 DE 18 DE018 | 18 | mcc | MERCHANT CATEGORY CODE | mcc | mcc_code mcc |
Merchant country code | DE19 DE 19 DE019 | 19 | merchant_country | MERCHANT COUNTRY CODE | merchant_location | details formatted_merchant_desc |
POS entry mode | DE22 DE 22 DE022 | 22 | entry_type | POS ENTRY MODE | de022 | |
PIN entry capability | DE22 DE 22 DE022 | 22 | pin_entry_capability | PIN ENTRY CAPABILITY | de022 | |
Amount, local surcharge | DE28 DE 28 DE028 | 28 | local_surcharge_amount | DE28 | local_surcharge_amt local_atm_surcharge | |
Settlement surcharge amount | DE29 DE 29 DE029 | — | settle_surcharge_amount | |||
Acquiring institution ID code | DE32 DE 32 DE032 | 32 | acquirer_id | ACQUIRING ID | acq_id | |
Retrieval reference number | DE37 DE 37 DE037 | 37 | RETRIEVAL REF NUMBER | |||
Authorization ID response | DE38 DE 38 DE038 | 38 | EXTERNAL TRANSACTION ID | |||
Response code | DE39 DE 39 DE039 | 39 | response_code | AUTHORIZATION RESPONSE | response_code | deny_code |
Acceptor terminal ID | DE41 DE 41 DE041 | 41 | terminal_id | TERMINAL ID | terminal_id | |
Merchant ID | DE42 DE 42 DE042 | 42 | merchant_id | MERCHANT NUMBER | merchant_number | merchant_id |
Merchant description | DE43 DE 43 DE043 | 43 | merchant_description | MERCHANT DESCRIPTION | merchant_name | details formatted_merchant_desc |
Merchant postal code | DE43 DE 43 DE043 | 43 | merchant_postal_code | MERCHANT POSTAL CODE | merchant_postal_code | details formatted_merchant_desc |
Merchant state | DE43 DE 43 DE043 | 43 | merchant_state | merchant_location | details formatted_merchant_desc | |
Track expiry | DE45 DE 45 DE045 | 45 | track_expiration_date | |||
Transaction initiator code | DE48 DE 48 SF 22 DE048SF22 | — | transaction_initiator_code | |||
Partial auth support | DE48 DE 48 SE 61 SF 1 DE048SE61SF1 | 60.10 | partial_supported | |||
Incremental auth | DE48 DE 48 SF 5 DE048SF5 | incremental_auth | ||||
Risk score | DE48 DE 48 SE 75 SF 3 DE048SE75SF3 | 62.21 | risk_score | RISK SCORE | risk_score | |
Risk code | DE48 DE 48 SE 75 SF 4 DE048SE75SF4 | risk_code | ||||
ECI/SLI | DE48 DE 48 SE 42 DE048SE42 | 44.13 | raw_eci | SLI INDICATOR | ||
TVR data | DE48 DE 48 SE 79 DE048SE79 | 131 | raw (TVR) | |||
IIAS indicator | DE48 DE 48 SE 61 SF 3 DE048SE61SF3 | — | iias_indicator | |||
Currency code, transaction | DE49 DE 49 DE049 | 49 | local_currency | LOCAL CURRENCY CODE TRANSACTION CURRENCY CODE | local_currency | local_curr_code |
Currency code, settlement | DE50 DE 50 DE050 | 50 | settle_currency | SETTLE CURRENCY CODE | settle_currency | settle_curr_code |
Currency code, billing | DE51 DE 51 DE051 | 51 | billing_currency | BILLING CURRENCY CODE | billing_curr_code | billing_curr_code |
Amount, cashback | DE54 DE 54 DE054 | 54 | cashback_amount | CASHBACK AMOUNT | cashback_amount | |
Advice reason code | DE60 DE 60 DE060 | 63.4 | stip {detail} | DE60 | stip_detail | |
Recurring transaction flag | DE61 DE 61 DE061 | 25 | recurring | RECURRING TRANSACTION FLAG | ||
Card-present indicator | DE61 DE 61 DE061 | 25 | cardholder_present | CARD PRESENT INDICATOR | card_not_present | |
Association transaction ID | — | 62 | ASSOCIATION TRANS ID | |||
AVS response | DE63 DE 63 SE 83 DE063SE83 | 44.2 | avs_result | ADDRESS VERIFICATION RESPONSE | — | |
MTI | DE90 DE 90 DE090 | 90 | mti | MTI | mti | |
BAI | — | 104 | bai | BAI | bai | |
Fleet Service Data | DE 106 DE106 | — | fleet_card_driver_number fleet_card_vehicle_number fleet_prompt_data merchant_override_indicator control_override_items fuel_info non_fuel_info | fleet_card_driver_number fleet_card_vehicle_number | ||
Additional STIP detail | DE 121 DE121 | 44.4 | stip_additional_detail | DE121 REASON CODES | stip_additional_detail | |
TAR info | DE 124 DE124 | — | tar_info | |||
IVA tax | DE 124 SF 2 DE124SF2 | — | IVA TAX | iva_tax | ||
IAC tax | DE 124 SF 11 DE124SF11 | — | IAC_TAX | iac_tax |