2.1 Primary Elements

Primary Elements are listed within a <Transactions> parent element, which defines the top-level entities of the message. See the table below for details.

Element Name	Description	Data Type	Occurs
CardAuthorisation	Describes an Authorisation or Reversal.	<CardAuthorisation>	0 - n
CardFinancial	Describes a Financial Advice or Financial Reversal.	<CardFinancial>	0 – n
CardChrgBackRepRes	Describes a Chargeback, Chargeback Reversal, Representment or Representment Reversal.	<CardChrgBackRepRes>	0 – n
CardFee	Describes a fee (and commission).	<CardFee>	0 – n
MasterCardFee	Describes a MasterCard fee.	<MasterCardFee>	0 – n
CardLoadUnload	Describes a Card Load, Card Load Reversal, Card Unload and Card Unload Reversal.	<CardLoadUnload>	0 – n
ApprovedAgencyBanking	Describes an approved Agency Banking transaction (relevant only if you are using the Agency Banking service)	<ApprovedAgencyBanking>	0 – n
DeclinedAgencyBanking	Describes declined Agency Banking transaction (relevant only if you are using the Agency Banking service)	<DeclinedAgencyBanking>	0 – n
AgencyBankingFee	Describes any bank charges applied to Agency Banking transaction (relevant only if you are using the Agency Banking service).	<AgencyBankingFee>	0 – n
CardBalAdjust	Describes a card account Balance Adjustment or Reversal.	<CardBalAdjust>	0 – n
CardEvent	Describes a card status change event.	<CardEvent>	0 – n
FXConversion	Describes Foreign Exchange (FX) rate conversion.	<FXConversion>	0 – n
WalletTransaction	Describes a wallet account transaction.	<WalletTransaction>	0 – n

The presence of primary elements within an XML message depends on the card activity for the period being reported. For example, <CardChrgBackRepRes> elements are only present when a chargeback (or reversal) or Representment (or reversal) is reported.

Transactional XML example showing several Primary Elements

Copy

<?xmlversion="1.0"encoding="utf-8"?>
<Transactions>
<CardAuthorisation>…detail ommitted…</CardAuthorisation>
<CardBalAdjust>…detail ommitted…</CardBalAdjust>
<CardChrgBackRepRes>…detail ommitted…</CardChrgBackRepres>
<CardFee>…detail ommitted…</CardFee>
<CardFinancial>…detail ommitted…</CardFinancial>
<CardLoadUnload>…detail ommitted…</CardLoadUnload>
<MasterCardFee>…detail ommitted…</MasterCardFee>
<WalletTransaction>…detail ommitted…</WalletTransaction>
</Transactions>