9.7 CardChrgBackRepRes

CardChrgBackRepRes describes the following record types:

  • Chargeback Advice

  • Chargeback Reversal

  • Representment Advice

  • Representment Reversal 

You can use the AdjustId element to uniquely identify the record and distinguish it from all other CardChrgBackRepRes records.

Child Element

Description

Data Type

Required

Constraints /

Permitted Values

RecordType

Indicates the type of CardChrgBackRepRes record.

xs:string

Yes

Valid values are:

CB = Chargeback Advice

CBREV = Chargeback Reversal

REPRES = Representment Advice

REPRESREV =Representment Reversal

ChgbackRepresId

Unique identitifier for this CardChrgBackRepRes record.

xs:unsignedLong

Yes

0 to 2^64

LocalDate

The date and time the record was generated by the terminal (POS or ATM) or acquirer.

<LocalDate>

Yes

See the LocalDate sub-element

SettlementDate

The date the transaction has been processed.

<SettlementDate>

Yes

See the SettlementDate sub-element

Card

Details of the card used in the transaction. 

<Card>

Yes

See the Card sub-element

Account

Details of the cardholder account.

<Account>

Yes

See the Account sub-element

TxnCode

Indicates the type of transaction.

<TxnCode>

Yes

See the TxnCode sub-element

TxnAmt

Indicates the value of the transaction requested by the cardholder.

<BasicAmount>

Yes

See the TxnAmt sub-element

CashbackAmt

Details of any cashback amount requested by cardholder. If no cashback is requested then populate with a zero value and the transaction currency code.

Not applicable to Discover.

<BasicAmount>

Yes

See the CashbackAmt sub-element

BillAmt

The amount posted to the cardholder account. This does not include interchange.

<RateAmount>

Yes

See the BillAmt sub-element

ApprCode

The approval code generated by the issuer and printed on the receipt.

<ApprCode>

Yes

See the ApprCode sub-element

Trace

Information used to uniquely identify the transaction.

Not applicable to Discover.

<Trace>

Yes

See the Trace sub-element

MerchCode

A unique code identifying the Merchant (also known as the Card Acceptor Identifier).

<Merch

Code>

Yes

See the MerchCode sub-element

Term

Describes the terminal used for the transaction.

<Term>

Yes

See the Term sub-element

Schema

Indicates the name of the card scheme.

<Schema>

Yes

See the Schema sub-element

Txn

Describes the validation/authentication properties used in a transaction.

<Txn>

Yes

See the Txn sub-element

MsgSource

Describes the derivative source of the record.

<MsgSource>

Yes

See the MsgSource sub-element

Repeat

Information to show the number of the chargeback/representment.

The Second Chargeback is not applicable to Discover.

xs:unsigned

Byte

Yes

Valid values are:

1 = First chargeback / representment

2 = Second Chargeback / representment

SettlementAmt

The amount posted to the settlement account.

<SettlementAmt>

Yes

See the Settlement sub-element

Fee

Interchange or service fee amount posted to the settlement account.

<DirectionAmount>

Yes

See the Fee sub-element

ARN

Acquirer Reference Number.

<ARN>

Yes

See the ARN sub-element

FIID

Forward Institution Identification code.

<FIID>

Yes

See the FIID sub-element

RIID

Receiving Institution Identification code.

<RIID>

Yes

See the RIID sub-element

ReasonCode

Message reason code.

xs:string

Yes

See Message_Reason Codes

Classification

Merchant classification for the transaction.

<Classification>

Yes

See the Classification sub-element

OrigTxnAmt

Original transaction amount. The value of the original transaction requested by the cardholder. This is used in the case of the transaction being a partial chargeback/representment, chargeback reversals or representment reversals.

<PartialAmount>

If applicable

See the OrigTxnAmt sub-element

PartialReversal

Indicates if the amount reversed is a partial amount of the original chargeback.

Xs:boolean

If applicable

Valid values are:

true = Partial Reversal;

false = Full Reversal

If not supplied, assumes “false”.

SettlementCycle

Shows the settlement cycle for the chargeback.

<SettlementCycle>

Yes

See the SettlementCycle sub-element

ReconciliationDate

Shows the reconciliation date for the chargeback.

<ReconciliationDate>

Yes

See the ReconciliationDate sub-element

ReconciliationCycle

Shows the reconciliation cycle for the chargeback.

<ReconciliationCycle>

Yes

See the ReconciliationCycle sub-element

Usage

Indicates whether the chargeback is manually credited to the card.

<Usage>

Yes

See the Usage sub-element

Pending_Billing_Amount

Value of the chargeback billing amount.

< Pending_Billing_Amount>

Yes

See the Pending_Billing_Amount sub-element

SettlementIndicator

Indicator for Domestic or International settlement.

SettlementIndicator

If applicable

See the SettlementIndicator sub-element

Additional_Amt_DE54

Additional amounts field where additional fees such as card network fees are held.

Not applicable to Discover.

<Additional_Amt_DE54>

If applicable

See the Additional_Amt_DE54 sub-element

ChargebackRefNum

Chargeback reference number, as displayed in Smart ClientClosed Smart Client is Thredd's legacy desktop application for managing your cards and transactions on the Thredd Platform..

Not applicable to Discover.

<ChargebackRefNum>

If applicable

See the ChargebackRefNum sub-element

Example

Copy
<CardChrgBackRepRes>
    <RecordType>CB</RecordType>
    <ChgbackRepresId>13961291974</ChgbackRepresId>
    <LocalDate>20240531011034</LocalDate>
    <SettlementDate>20240531</SettlementDate>
    <Card PAN="57928830200321" product="DGN" programid="PPCITY" productid="1463" branchcode="" />
    <Account no="304826674" type="07" />
    <TxnCode direction="credit" Type="pos" Group="pos" ProcCode="000000" />
    <TxnAmt value="0.00" currency="826" />
    <CashbackAmt value="0.00" currency="826" />
    <BillAmt value="0.00" currency="826" rate="1.000000000" />
    <ApprCode>192625</ApprCode>
    <Trace auditno="483714" origauditno="483714" Retrefno="            " />
    <MerchCode>5ZUIIHJWQRTRO6H</MerchCode>
    <Term code="45928071" location="AIR MALTA\25 SOUTH STREET\VALLETTA\VL1 8DQ      470" street="25 SOUTH STREET" city=" VALLETTA" country="MT" inputcapability="0" authcapability="1" />
    <Schema>DGN</Schema>
    <Txn cardholderpresent="" cardpresent="" cardinputmethod="0" cardauthmethod="" cardauthentity="" TVR="0" TTI="" />
    <MsgSource value="70" domesticMaestro="no" />
    <Repeat>1</Repeat>
    <SettlementAmt value="0.00" currency="826" rate="1.000000000" date="20240531" />
    <Fee value="0.00" currency="826" direction="debit" />
    <ARN>92374186</ARN>
    <FIID / >
    <RIID>00000361603</RIID>
    <ReasonCode>C06</ReasonCode>
    <Classification MCC="5977" />
    <OrigTxnAmt value="38.53" currency="826" />
    <PartialReversal>false</PartialReversal>
    <SettlementCycle xsi:nil="true" />
    <ReconciliationDate xsi:nil="true" />
    <ReconciliationCycle xsi:nil="true" />
    <Usage>0</Usage>
    <Pending_Billing_Amount>38.53</Pending_Billing_Amount>
    <Additional_Amt_DE54 xsi:nil="true" />
    <ChargebackRefNum />
    <SettlementRecapId RecapDate="20240531" RecapNumber="094" SendingIIC="00000361641" ReceivingIIC="00000361603" CurrencyCode="826" />
 </CardChrgBackRepRes>