Description of _transaction_.csv

All <date in utc>_transaction_*.csv files are built the same way. The date is in UTC format.

The following files will appear on the SFTP server:

YYYYMMDDZ_transaction_failed.consolidated.csv

YYYYMMDDZ_transaction_fundsmissing.consolidated.csv

YYYYMMDDZ_transaction_fundsreceived.consolidated.csv

YYYYMMDDZ_transaction_indoubt.consolidated.csv

YYYYMMDDZ_transaction_pending.consolidated.csv

YYYYMMDDZ_transaction_succeeded.consolidated.csv

For more information regarding different transaction states, check the The transaction process.

Explanation of fields:

TitleDescriptionType
TXIDThe PPRO Transaction IDnumeric
TXSTATEThe transaction statestring
FAILTYPEThe failtype (if the transaction ever failed)string`
FUNDSTATEThe fund statestring
AMOUNTThe amount of transaction in centsnumeric
CURRENCYThe currency of the transactionstring
ACCOUNTHOLDERThe account holder of the transactionstring
TAGThe name of the channel on which the transaction was processed (livechannel or testchannel)string
MERCHANTTXIDClient-generated merchant transaction identifierstring
COUNTRYCODETwo-letter country code of the transactionstring
SELLINGPOINTOptional field sent in by PSP/Merchantstring
SOLDSERVICEOptional field sent in by PSP/Merchantstring
INITTSThe timestamp of transaction initiation (UTC time)string
SUCCEEDEDTSThe timestamp (if) the transaction state changed to succeeded (UTC time)string
FAILEDTSThe timestamp (if) the transaction state changed to failed (UTC time)string
INDOUBTTSThe timestamp (if) the transaction state changed to indoubt (UTC time) (deprecated, remains for backwards compatibility)string
FUNDSRECEIVEDTSThe timestamp (if) the transaction fundstate changed to state received (UTC time)string
FUNDSMISSINGTSThe timestamp (if) the transaction fundstate changed to missing (UTC time)string
ERRORTEXTIf an error occurred, this is the human-readable error text for the specific transactionstring
ADD.<additional fields>If a scheme requires additional input on the transaction API (specin parameters), the information is echoed in an individual ADD field per specin parameter.

Example:
specin.consumerref appears in the Processing files as ADD.CONSUMERREF.
string
OUT.<additional fields>If a scheme emits additional output on the transaction API (SPECOUT parameters), the information is echoed in an individual OUT field per SPECOUT parameter.

Example:
SPECOUT.SRCIBAN appears in the Processing files as OUT.SRCIBAN.
string
MCONTRACTOnly appears if using consolidated files. This is the merchant contract IDstring

📘

Note

The number of ADD and OUT fields and values can vary, depending on the data emitted by the scheme.