Treasury :: Bureau of the Fiscal Service
Enterprise Data Architecture
Transmission Data Exchange


Data Exchange Catalogue
Transmission
Summary
Batch
BusinessTransaction
FinancialTransaction
PlasticCardDetail [0..1]
CardOrder [0..1]

Element Information
NamePlasticCardDetail
DefinitionContains plastic card information.
DataTypeContainer
Attribute Information
Attribute NameUseDataTypeDefinition
MonthYearExpireoptional (([0][1-9])|([1][0-2]))[0-9]{2}Indicates the month/year value of a card's expiration date.
CardNumberoptional [0-9]{15,16}|[0-9]{4,4}Contains a credit card or debit card number.
MaskedCardNumberoptional String [0, 19]Contains the masked credit card or debit card number.
CardSecurityCodeoptional [0-9]{3,4}A 3 or 4 digit value printed on the card or signature strip but not available on the magnetic strip.
OriginalInterchangeCodeoptional String [0, 2]A two character code assigned by Fifth Third that provides the business type for the transaction. All agencies are 19 for public sector except DeCA which is 04 for supermarkets.
InterchangeCodeoptional String [0, 9]A code the identifies the type of transaction that the interchange fee applies to and dictates the interchange fee amount applied to the transaction.
InterchangeReimbursementFeeAmountoptionalDecimal [15, 9]The amount that the merchant must pay to the network carrier (i.e. Visa, MasterCard, AMEX, Discover) representing the true cost of a plastic card transaction.
InterchangeReimbursmentFeeAmountSignIndicatoroptional- [Indicates the amount is negative.], + [Indicates the amount is positive.]The sign of the Interchange Reimbursement Fee Amount. If the Interchange Adjustment Amount is less than zero then this value equals '0' else it equals '1'.
InterchangeAdjustmentReasonCodeoptional String [0, 3]A one character code that defines why the surcharge, downgrade or adjustment was done. Examples of codes and their meanings are: A Missing MC Registration Code B Missing/ Invalid POS Entry Mode a Key Entered, No AVS Attempted b Key Entered, No Zip Match
InterchangeAdjustmentAmountoptionalDecimal [15, 9]The amount that the merchant must pay to the network carrier (i.e. Visa, MasterCard, AMEX, Discover) representing the true cost of a plastic card transaction.
InterchangeAdjustmentAmountSignIndicatoroptional- [Indicates the amount is negative.], + [Indicates the amount is positive.]The sign of the Interchange Adjustment Amount. If the Interchange Adjustment Amount is less than zero then this value equals '0' else it equals '1'.
AuthorizationCharacteristicsCodeoptional String [0, 2]A one character code that defines if the card was presented for authorization, whether the merchant name and location were provided, if the card was not provided what authorization was used. Examples of codes and their meanings: 'A' Card present; 'C' Card present with merchant name and location data (cardholder-activated, self-service terminal) meets card-present criteria; 'R' Card not present
AuthorizationCodeoptional String [0, 6]A three character code that defines how the authorization for the card was read. The first two positions refer to how the card was read and the third position refers to the capture of the PIN. Examples of codes and their meanings for the first 2 positions: '02' Magnetic Stripe Read, '07' Contactless Magnetic Chip (MICR Reader for POS Check), Blanks Entry Mode Not Known. Examples of codes and their meanings for the third position: '0' Unknown, '1' Terminal Can Accept and Capture PINS, '2' Terminal Cannot Accept and Capture PINS, '3' PIN Pad Inoperative
AuthorizationSourceCodeoptional String [0, 1]A one character code that identifies the authorization source for the card transaction. Examples of codes and their meanings are: '1' STIP Time Out Response, '2' STIP Time Out Response, Below Issuer Limit, '8' Acquirer Approval Of Referral, '9' Automated Referral Service Response, 'T' Terminal (Fleet transactions only), Blanks Authorization Source Not Known
AVSResponseCodeoptional String [0, 2]A one character code that the merchant received when processing the transaction related to the processing of the address information. Examples of codes and their meanings are: Blank Not Applicable, 'A' Address matches, but ZIP code does not match, 'X' Exact match, address, and nine-digit ZIP code match. 'Y' Address and 5 digit ZIP code match
MerchantStoreNumberoptional String [0, 9]A nine digit merchant store number assigned by Fifth Third. Field is right justified and zero filled. Example: '000054321'
MerchantCategoryCodeoptional String [0, 25]The Merchant Category Code designates the type of merchant business (food, department store, etc.) for a credit card transaction.
MerchantNumberoptional String [0, 18]The unique identifier of the Plastic Merchant .as assigned by the settlement engine. For collections activities this identifier currently uniquely represents an Agency within the card settlement engine.
CardProductTypeoptional String [0, 3]A three character code valid only for Visa, Discover and MasterCard that provides information on the type of card. Examples of codes and their meanings are: 'CC' Visa Classic Credit, 'CCW' Visa Classic Credit Traditional Rewards, 'TC' Visa Travel Voucher Credit, 'MD' MasterCard Debit Card, 'HD' Visa Infinite Debit 'MDG' Gold MasterCard Debit Card, '002' Discover Commercial Credit
ClientBatchNumberoptional String [0, 6]A six character client Batch Number if supplied. Pay.gov does provide a batch number.
CashBackAmountoptionalDecimal [20, 2]Min Inclusive: 0.00Amount of money that is added to the total purchase price of a transaction (paid by debit card). The customer receives the extra amount in cash along with their goods.
CardNetworkTypeoptional String [0, 20]Identifies the type of network the plastic card used for a payment. Valid Values: VISA, MCRD, AMEX, DISC, DSCV, STAR, NYC1, INLK
CardProductCodeoptional String [0, 2]The type of card used for the transaction, for example, AX (American Express).
NetworkResponseFieldoptional String [0, 25]A string of fields used to define the card provider's response. Different strings are used for Visa, for MasterCard, and for all other provider response codes. For Visa: 15 character Transaction ID + 4 character Validation Code and a 2 character Authorization Response Code. For MasterCard: 9 Character Banknet Reference Number + 4 character Banknet Settlement Date + 8 characters that are reserved for future use. For all other providers: Business Date -MMDDCCYY format + 12 character Retrieval Reference Number + 1 character CAVV Response + 1 character Void Indicator + 3 character Origin Type + 2 character Visa Card Level Results/Visa Product Code.
CardChargebackReferenceNumberoptional String [0, 12]The network reference number related to the chargeback.
CardResponseCodeoptional String [0, 2]A two character code used for credit and gift cards that specifies how and if the card security code was processed.
CardChargebackRecordNumberoptional String [0, 12]For any single customer transaction that is questioned, this number relates all Disputes and subsequent records. Format for the record number is YDDDSSSSSSOO where: YDDD = Date item was first received from network, SSSSSS = Sequence number in Card Acquiring Services CHARTS system, OO = Occurrence record number. A six character client Batch Number if supplied. Pay.gov does provide a batch number.
DraftLocatorNumberoptional String [0, 11]Customer Supplied Data for Data Matching. (11 characters)
CAT_Codeoptional String [0, 2]A one character code that provides the type of Cardholder Activated Terminal (CAT). Examples of codes and their meanings are: '0' CAT Not Applicable, '1' Type A UAT- Limited Amount Terminal, '2' Type C UAT - Automated Dispensing Machine, '3' Type B UAT - Self-Service Terminal, '4' Remote
POSEntryModeoptional String [0, 3]A three character code that provides the entry mode. The first two positions refer to how the card was read and the third position refers to the capture of the PIN. Examples of codes and their meanings for the first 2 positions: '02' Magnetic Stripe Read, '07' Contactless Magnetic Chip (MICR Reader for POS Check), Blanks Entry Mode Not Known. Examples of codes and their meanings for the third position: '0' Unknown, '1' Terminal Can Accept and Capture PINS, '2' Terminal Cannot Accept and Capture PINS '3' PIN Pad Inoperative
RegisterNumberoptional String [0, 4]A four character number provided if available with the number of the register where the card transaction occurred.
StorePersonIdentifieroptional String [0, 9]A nine character ID that may be supplied by the merchant.
TerminalNumberoptional String [0, 15]A nine character number provided if available with the number of the terminal where the card transaction occurred.
TransactionTimeZoneoptional String [0, 3]A three character code with the Time Zone of the merchant. For example, 'EDT', 'EST', 'CDT'
TransactionTimeoptionalHH:MM:SS or may end in 'Z' to reflect UTC (Coordinated Universal Time)The time of the transaction (along with transaction date). The format is HHMM.
ChannelCutoffTimeoptionalHH:MM:SS or may end in 'Z' to reflect UTC (Coordinated Universal Time)Allows an agency in Pay.gov to set their 24 hour day for plastic card payments. The time determines when a transaction will be sent for settlement
CardEventTypeoptional String [0, 15]Event Type of the plastic card transaction. Valid values: Sale, Authorization, Force Credit, Void Sale, Void Credit
AuthorizationRequestResponseCodeoptional String [0, 2]Indicates whether the transaction is approved or declined. If declined, it will indicate why it was declined.
PlasticTypeCodeoptionalCRT [Credit Card], DBT [Debit Card], EBT [Electronic Benefit Card], GFT [Gift Card]Indicates plastic medium used.
IsRecurringoptional 1|0Indicates if the item is a recurring transaction.
AdjustmentTypeoptional String [0, 10]Type of adjustment item.
Technical Information
Schema versionurn:us:gov:treasury
Cardinality[0..1]
Content ModelThe <PlasticCardDetail> element contains 1 child element and has a sequence content model. The sequence content model means that there is a particular order to the children elements of the parent element - in this case, the <PlasticCardDetail> element has a particular order of elements that must be followed.


For help, please contact the Treasury Bureau of the Fiscal Service Data Registry team.
Last Updated: 2015-01-17T06:09:53.339-05:00

This web site is informative only and may contain publishing errors/inconsistencies - please carefully review the appropriate XML Schema documents in the Download section.