> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enfuce.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Transaction file description
> The transaction file contains detailed information on each financial transaction. It includes key data fields such as transaction date, amounts, currencies, merchant details, authorization codes, and transaction status. This file serves as a comprehensive record for reconciling and analyzing transactions.
## Transaction
| Field name | Field type | Mandatory | Details | |
| :------------------------------ | :------------- | :-------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - |
| REPORTING\_DATE | DATE | DATE | YYYY-MM-DD.
The date when transactions have been posted. Data has been extracted end of day of this date. Files are provided the next day. | |
| INSTITUTION\_ID | NUMBER(6,0) | Yes | The institution ID setup at Enfuce. | |
| ADD\_INFO | VARCHAR2(3900) | No | Additional field which contains miscellaneous data of transaction. Data is marked with tags. These tags vary depending on the payment network (e.g., Visa, Mastercard) and include various attributes like Submerchant ID, Interchange Fee, Wallet Type, etc.
Tag Submerchant ID: Visa VF104\_2\_56\_2 Mastercard MDE4837\_3.
Tag Interchange fee from Visa:IRF\_AMOUNT=xx.xx;IRF\_CURR=xxx.
Tag wallet data: WALLET\_TYPE=(such as ApplePay). | |
| AUTH\_CODE | VARCHAR2(32) | No | The authorisation code of the transaction. The authorisation code is usually 6 digits and is assigned either by Enfuce or Payment scheme in case of stand-in processing. The authorisation code is not unique, the same authorisation code can appear multiple times. Note that it is also possible that not all transactions are authorised, in which case there is no authorisation code. | |
| BANKING\_DATE | DATE | DATE | YYYY-MM-DD.
The system’s banking date when the transaction has been processed. | |
| CARD\_SEQUENCE\_NUMBER | VARCHAR2(32) | No | The card sequence with which the transaction has been performed. | |
| CORRECTED\_ID | NUMBER(18,0) | No | Updated database ID for the transaction after correction. | |
| CORRECTION\_TYPE | VARCHAR2(32) | No | If the transaction has been corrected this field states the type of correction that has been made. The possible values are: J (= Adjustment), R (=Reversal), \* (=Repost) | |
| DIRECTION | VARCHAR2(6) | No | Describes if the transaction is debiting or crediting. Possible values: Credit, Debit. | |
| ID | VARCHAR2(32) | Yes | Enfuce generated database ID for the transaction. The ID is unique among transactions and authorisations. | |
| MAIN\_ID | NUMBER(18,0) | No | Related main transaction id. Relevant for transactions for which there are linked line items. | |
| TRANS\_AMOUNT | NUMBER(28,10) | No | The amount of the transaction in the currency the merchant has charged it in. E.g. if a customer makes a purchase in USD and the cards currency is EUR. Then the TRANSACTION\_AMOUNT will be in USD and SETTLEMENT\_AMOUNT in EUR. If the purchase is done in the same currency as the cards currency the TRANSACTION\_AMOUNT=SETTLEMENT \_AMOUNT. | |
| TRANS\_CURRENCY | VARCHAR2(3) | No | The currency in which the transaction was made. | |
| TRANS\_DATE | DATE | No | The local date (and time) when the transaction was made. Local date/time= the date/time in the time zone in which the payment terminal is: YYYY-MM-DDThh:mm:ss
For MasterCard transactions, the date and time stamp both are provIDed as those both are available in a clearing file.
For Visa, only the date is available as Visa only includes the date in clearing files. | |
| TRANS\_ARN | VARCHAR2(32) | No | Transaction Identification number, generated by the acquirer according to payment scheme rules (Acquirer Reference Number). | |
| TRANS\_CITY | VARCHAR2(32) | No | Merchant city | |
| TRANS\_COUNTRY\_CODE | VARCHAR2(32) | No | Merchant country | |
| TRANS\_DETAILS | VARCHAR2(255) | No | Merchant name | |
| TRANS\_IRN | VARCHAR2(32) | No | Transaction Identification number, provided to the payment scheme by the issuer (Issuer Reference Number). | |
| TRANS\_MCC | VARCHAR2(32) | No | The merchant category code of the transaction (ISO 18245). | |
| TRANS\_REASON | VARCHAR2(3900) | No | If transaction has been disputed, this fields may contain additional information about the dispute. | |
| TRANS\_RESPONSE\_CODE | VARCHAR2(32) | No | Additional information related to the posting. In combination with the posting status it indicates in both successful and non-successful cases if any additional findings were done during the posting.
Note that the response code is just additional information on top of the posting status. Regardless of the response code, the posting status determines if the transaction is successfully posted or not. See possible values in the [Transaction Response Code Guide](/guides/the-essentials/global-processing/authorisation-and-authentication-of-payments#response-codes). | |
| TRANS\_RRN | VARCHAR2(32) | No | Transaction Identifier, generated according to payment scheme rules (Retrieval Reference Number) | |
| TRANS\_SRN | VARCHAR2(255) | No | Registration number, assigned by the merchant or acquirer (Source Registration Number). | |
| MERCHANT | VARCHAR2(32) | No | ID number of the merchant (as informed in the incoming clearing file). | |
| PAYEE\_COUNTRY\_CODE | VARCHAR2(32) | No | In person to person payments, the registered country of the payee. | |
| PAYER\_COUNTRY\_CODE | VARCHAR2(32) | No | In person to person payments, the registered country of the payer. | |
| POSTING\_STATUS | VARCHAR2(32) | No | Indicates if Enfuce has successfully posted the transaction during transaction processing to a card or account. Possible values:
“Posted”
The posting status will be “posted” when transaction has been successfully posted to card or account. This is the posting status of all successful transactions that are still valid.
“InActive”
The posting status of the original transaction will be updated to “InActive” if a reversal transaction linked to it is successfully posted.
“Closed”
If a reversal is posted the posting status “Closed” of the reversal transaction will indicate that it is successfully posted, i.e. the transaction has been successfully reversed.
“Decline Service”
The transaction could not be posted to card or account. One example is that the transaction type is not permitted to card or account.
“Decline”
The transaction could not be posted to card or account. One example is that the card or account status does not allow posting.Mapping to Transaction API postingStatus:”POSTED” = “Posted”
“POSTED\_DISPUTE” = “Decline Service”
“CLOSED” = “Closed”
“PENDING” = N/A in batch file (transaction is only pending for a short period of time while being processed)
“REJECTED” = “Decline” | |
| PREVIOUS\_ID | NUMBER(18,0) | No | Database ID linking the transaction to a previous authorisation or transaction. | |
| SETTLEMENT\_DATE | DATE | No | YYYY-MM-DD.
The date the transaction was processed in Enfuce system. | |
| SETTL\_AMOUNT | NUMBER(28,10) | No | Payment scheme settlement amount. Settlement amount is the gross amount that needs to be settled to payment scheme. The settlement amount does not include any transaction based fees calculated by Enfuce e.g. mark-up or ATM fee. | |
| SETTL\_CURRENCY | VARCHAR2(3) | No | Payment scheme settlement currency | |
| LOCAL\_AMOUNT | NUMBER(28,10) | No | The total amount in the cardholder's currency. This amount does not include any transaction-based fees calculated by Enfuce, such as mark-up or ATM. | |
| SOURCE\_CARD\_REFERENCE\_NUMBER | VARCHAR2(255) | No | Foreign key to transaction source card. | |
| SOURCE\_CARD\_ID | NUMBER(18,0) | No | Foreign Enfuce generated key to transaction source card. | |
| SOURCE\_CONTRACT\_NUMBER | VARCHAR2(255) | No | Foreign key to transaction source account. | |
| SOURCE\_ACCOUNT\_ID | NUMBER(18,0) | No | Foreign Enfuce generated key to transaction source account. | |
| SOURCE\_CATEGORY | VARCHAR2(32) | No | Possible values: Accountant, Contract, Merchant | |
| SOURCE\_CHANNEL | VARCHAR2(32) | No | Possible values:
“VISA”:Used for settlement records
“Our Visa Cards”:Used for card transactions received in clearing files
“Mastercard (IPM)”:Used for settlement records
“Our MC Cards”:Used for card transactions received in clearing files
“RBS”:Used for incoming payments
“Internal”:Used for transactions posted via API
“Affiliated”:Used for closed loop transactions | |
| SOURCE\_COUNTRY\_CODE | VARCHAR2(32) | No | Country code of where the transaction has been performed. | |
| SOURCE\_MEMBER\_IDN | VARCHAR2(32) | No | Acquirer ID (DE 32 in ISO 8583) | |
| SOURCE\_MESSAGE\_CODE | VARCHAR2(32) | No | | |
| SOURCE\_NUMBER | VARCHAR2(255) | No | Merchant terminal ID | |
| SOURCE\_ON\_US\_FLAG | VARCHAR2(32) | No | If the transaction source is a closed loop (=on us) or not. | |
| TARGET\_CARD\_REFERENCE\_NUMBER | VARCHAR2(255) | No | Foreign key to transaction target card. | |
| TARGET\_CARD\_ID | NUMBER(18,0) | No | A card ID of a card to which a transaction has been posted to. | |
| TARGET\_CONTRACT\_NUMBER | VARCHAR2(255) | No | Foreign key to transaction target account. | |
| TARGET\_ACCOUNT\_ID | NUMBER(18,0) | No | An account ID to which a transaction has been posted to. | |
| TARGET\_CATEGORY | VARCHAR2(32) | No | Possible values: Accountant, Contract, Merchant | |
| TARGET\_CHANNEL | VARCHAR2(32) | No | Possible values:
“VISA”
Used for settlement records
“Our Visa Cards”
Used for card transactions received in clearing files
“Mastercard (IPM)”
Used for settlement records
“Our MC Cards”
Used for card transactions received in clearing files
“RBS”
Used for incoming payments
“Internal”
Used for transactions posted via API
“Affiliated”: Used for closed loop transactions | |
| TARGET\_COUNTRY\_CODE | VARCHAR2(32) | No | Country code of where the transaction has been posted to. | |
| TARGET\_MEMBER\_IDN | VARCHAR2(32) | No | Transaction target. | |
| TARGET\_MESSAGE\_CODE | VARCHAR2(32) | No | | |
| TARGET\_NUMBER | VARCHAR2(255) | No | | |
| TARGET\_ON\_US\_FLAG | VARCHAR2(32) | No | If the transaction target is a closed loop (=on us) or not. | |
| CONDITION\_LIST | VARCHAR2(3900) | No | See possible values in the [Transaction Condition Guide](/guides/the-essentials/global-processing/transaction-conditions/). | |
| TRANS\_TYPE\_NAME | VARCHAR2(255) | No | Configured name of the transaction type. See possible values in the [Financial Transaction Guide](/guides/the-essentials/global-processing/financial-transaction) | |
| TRANS\_TYPE\_CODE | VARCHAR2(32) | No | Code of the transaction type. See possible values in the [Financial Transaction Guide](/guides/the-essentials/global-processing/financial-transaction) | |
| TRANS\_TYPE\_SERVICE\_CLASS | VARCHAR2(32) | No | Service class of the transaction type. | |
| POSTING\_DATE | DATE | | YYYY-MM-DD.
On which Enfuce has processed the transaction. In practice, a date when Visa/MC has sent a clearing file including the transaction to Enfuce and Enfuce has imported the respective clearing file to Enfuce system. | |
| FEE\_1\_CODE | VARCHAR2(32) | No | Transaction fee 1 type code | |
| FEE\_1\_AMOUNT | NUMBER(28,10) | No | Transaction fee 1 amount | |
| FEE\_1\_CURRENCY | VARCHAR2(3) | No | Transaction fee 1 currency | |
| FEE\_2\_CODE | VARCHAR2(32) | No | Transaction fee 2 type code | |
| FEE\_2\_AMOUNT | NUMBER(28,10) | No | Transaction fee 2 amount | |
| FEE\_2\_CURRENCY | VARCHAR2(3) | No | Transaction fee 2 currency | |
| FEE\_3\_CODE | VARCHAR2(32) | No | Transaction fee 3 type code | |
| FEE\_3\_AMOUNT | NUMBER(28,10) | No | Transaction fee 3 amount | |
| FEE\_3\_CURRENCY | VARCHAR2(3) | No | Transaction fee 3 currency | |
| FEE\_4\_CODE | VARCHAR2(32) | No | Transaction fee 4 type code | |
| FEE\_4\_AMOUNT | NUMBER(28,10) | No | Transaction fee 4 amount | |
| FEE\_4\_CURRENCY | VARCHAR2(3) | No | Transaction fee 4 currency | |
| FEE\_5\_CODE | VARCHAR2(32) | No | Transaction fee 5 type code | |
| FEE\_5\_AMOUNT | NUMBER(28,10) | No | Transaction fee 5 amount | |
| FEE\_5\_CURRENCY | VARCHAR2(3) | No | Transaction fee 5 currency | |
| SOURCE\_MEMBER\_COUNTRY | VARCHAR2(3) | No | Acquirer country code. The country is informed according to ISO 3166 Alpha-3 standard. | |
| COMMENT\_TEXT | VARCHAR(255) | No | Free “text” data submitted during Transaction API transaction posting | |