Specifications
| JSON PATH | Description | Example | |
|---|---|---|---|
| file_date_and_time | UTC Date transmitted by processor Format: YYYY-MM-DD hhmmss | 2024-01-15 011023 | |
| total_number_of_records | Details how many records are included in the report | 1 | |
| authorizations | |||
| program_name | Program Name associated with the card. Generated by CLOWD9 represented as a GUID | CLOWD9 Travel | |
| program_id | Program Name associated with the card. Generated by CLOWD9 represented as a GUID | b33bf1dc-30f4-498f-b7ad-3e23b7f0180e | |
| product_id | Program Name associated with the card. Generated by CLOWD9 represented as a GUID | 7ab1e3e2-32cc-4e8f-96af-50fc158a4bd5 | |
| card_id | The ID of the card associated to the transaction | 9fc53743-247b-185f-8720-13be7ac028b6 | |
| card_ending | The last four digits of the PAN | 1234 | Under Development |
| bin | 8 digit value for the BIN the card_id is associated with. Subject to the network, this could be 6 digits | 12345678 | |
| bin_type | Reserved for future use | ||
| network_name | The network associated with the BIN and card_id | visa Mastercard | |
| mti | Numeric network specific identifier of the financial operation | 0100 | |
| message_type | Type of message received from the Network | Authorization Request | |
| transaction_id | The unique identifier (UUID) of the transaction log entry in the CLOWD9 database. Generated by CLOWD9 represented as a GUID | 71a78503-5b49-42d1-ae89-4280a12b9af2 | |
| system_trace_audit_number | The System Trace Audit Number for the network message if present/applicable | 123456 | |
| retrieval_reference_number | The Retrieval Reference Number for the network message if present/applicable | 12345678910 | |
| network_transaction_id | The unique identifier of the transaction assigned by the network, such as Visa TID. Reserved for future use for Mastercard | 204145677823994 | |
| result | Indicates based on the response code the authorization outcome | Approved Declined | |
| direction | To identify if the amount is a Debit or Credit | Debit Credit | |
| response_code | Response code of the transaction. In notification messages, it is the final outcome of the authorization process. In request messages, it may contain a value indicating the outcome of previous checks | 000 100 | |
| response_source | Indicates the source of the response_code value. For Off Ledger products, your source name will be provided | scheme CLOWD9 your source name network | |
| response_reason | A description of the reason for the assigned response_code. See Appendix ii for reasons | Approved Do Not Honour | |
| transaction_type | The numerical value for the transaction service and used to identify the service type. See Appendix iii for types | 00 | |
| transaction_service | The alpha value associated with the transaction_type | Goods and Services | |
| authorization_code | The code generated by CLOWD9 or the network following a successful authorization | 038247 | |
| transaction_life_cycle_id | Unique identifier generated by the Network during the Authorization | MDT0023J3 | |
| transaction_local_date | The local date at the point of transaction origination, YYYYMMDD | 20230108 | |
| transaction_local_time | The local time at the point of transaction origination, HHMMSS | 210608 | |
| transaction_amount | The amount to be authorized with the transaction in units. Can be “0” for non-financial messages | 225 | |
| transaction_currency_code | The Numeric currency code in which transaction_amount is represented | 978 | |
| transaction_currency | The Alpha (2-3) currency code in which transaction_amount is represented | EUR | |
| cardholder_billing_amount | The cardholder currency amount to be authorized in units. This amount may differ to the transaction_amount where the transaction currency is different to card settlement currency | 190 | |
| cardholder_billing_conversion_rate | Rate provided by the Network represented as a string in decimal format Domestic values will use the rate 1.0000000 or 1 | 1 | |
| cardholder_billing_currency_code | The Numeric currency code in which cardholder_billing_amount is represented. Note that this may have implications for the decimal place | 826 | |
| cardholder_billing_currency | The Alpha (2-3) currency code in which cardholder_billing_amount is represented | GBP | |
| additional_amount | Additional amount for example cashback | 100 | |
| additional_amount_currency_code | The currency code of the additional amount. Should match the authorization currency code | 826 | |
| additional_amount_type | Identifies the type of additional amount | Cashback | |
| card_acceptor_country_name | The country of the card acceptor entity in Alpha 2-3 | GB GBR | |
| card_acceptor_post_code | The post code of the card acceptor entity | AB1 2CD | |
| merchant_category_code | The Merchant Category Code | 5542 | |
| card_acceptor_name | The name of the card acceptor entity | 7 CLOWD9 Street | |
| card_acceptor_terminal_id | The identifier of the terminal where the transaction took place | 35043598 | |
| card_acceptor_city | The city of the card acceptor entity | London | |
| card_acceptor_country_code | The Alpha (2-3) country code of the card_acceptor | GBR | |
| acquiring_institution_id_code | The identification code of the Acquiring Institution | 015909 | |
| forwarding_institution_id_code | The identification code of the Forwarding Institution | 023748 | |
| chip_indicator | Indicates if the transaction was made using the Integrated Circuit Card (ICC Chip) i.e. Contact / Contactless. See Appendix iv for values and meaning | contact | |
| pin_indicator | Indicates whether PIN for the transaction was checked, its nature and the result. See Appendix v for values and meaning | y n | |
| dcc_indicator | Indicates whether Dynamic Currency Conversion took place | y n | |
| 3ds_indicator | Indicates whether 3D-Secure Authentication took place for this transaction | y n | |
| eci | E-Commerce authentication indicator. For an e-commerce transaction, when available, identifies the various security measures applied before transaction submission. See Appendix vi for values and meaning | 0 | |
| cardholder_condition | Cardholder condition indicator provided during the authorization. Possible values are: “00” cardholder present, normal transaction “01” cardholder not present “02” cardholder present “03” card present, suspicious activity “05” cardholder present “08” cardholder not present, mail or telephone order “59” cardholder not present, electronic order (ecommerce) “71” cardholder present (Used in US only) | string | |
| trace_id | A unique value used to assist with locating the transaction | d27aa3ad557092196b87e8e24d5b12f | |
| transaction_linkid | The Identifier of the transaction assigned by the Network. The Identifier will be provided in all future Financial messages | mxtw204145677823994 |
Updated 23 days ago