Treasury :: Financial Management Service
Enterprise Data Architecture
Transmission Business Message


Business Message Listing
Transmission
Batch
BusinessTransaction
FinancialTransaction
PlasticCardDetail [0..1]
CardOrder [0..1]

Element Information
NamePlasticCardDetail
DefinitionContains plastic card information.
Namespaceurn: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.
Attribute NameUseDataTypeDefinition
MonthYearExpire[0..1] (([0][1-9])|([1][0-2]))[0-9]{2}Indicates the month/year value of a card's expiration date.
CardNumber[0..1] [0-9]{15,16}|[0-9]{4,4}Contains a credit card or debit card number.
MaskedCardNumber[0..1] String [0, 19]Contains the masked credit card or debit card number.
CardSecurityCode[0..1] [0-9]{3,4}A 3 or 4 digit value printed on the card or signature strip but not available on the magnetic strip.
OriginalInterchangeCode[0..1] 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.
InterchangeCode[0..1] 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.
InterchangeReimbursementFeeAmount[0..1]Decimal [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.
InterchangeReimbursmentFeeAmountSignIndicator[0..1]- [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'.
InterchangeAdjustmentReasonCode[0..1] 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
InterchangeAdjustmentAmount[0..1]Decimal [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.
InterchangeAdjustmentAmountSignIndicator[0..1]- [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'.
AuthorizationCharacteristicsCode[0..1] 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
AuthorizationCode[0..1] 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
AuthorizationSourceCode[0..1] 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
AVSResponseCode[0..1] 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
MerchantStoreNumber[0..1] String [0, 9]A nine digit merchant store number assigned by Fifth Third. Field is right justified and zero filled. Example: '000054321'
MerchantCategoryCode[0..1] String [0, 25]The Merchant Category Code designates the type of merchant business (food, department store, etc.) for a credit card transaction.
MerchantNumber[0..1] 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.
CardProductType[0..1] 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
ClientBatchNumber[0..1] String [0, 6]A six character client Batch Number if supplied. Pay.gov does provide a batch number.
CashBackAmount[0..1]Decimal [20, 2]Amount 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.
CardNetworkType[0..1] 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
CardProductCode[0..1] String [0, 2]The type of card used for the transaction, for example, AX (American Express).
NetworkResponseField[0..1] 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.
CardChargebackReferenceNumber[0..1] String [0, 12]The network reference number related to the chargeback.
CardResponseCode[0..1] String [0, 2]A two character code used for credit and gift cards that specifies how and if the card security code was processed.
CardChargebackRecordNumber[0..1] 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.
DraftLocatorNumber[0..1] String [0, 11]Customer Supplied Data for Data Matching. (11 characters)
CAT_Code[0..1] 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
POSEntryMode[0..1] 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
RegisterNumber[0..1] String [0, 4]A four character number provided if available with the number of the register where the card transaction occurred.
StorePersonIdentifier[0..1] String [0, 9]A nine character ID that may be supplied by the merchant.
TerminalNumber[0..1] String [0, 15]A nine character number provided if available with the number of the terminal where the card transaction occurred.
TransactionTimeZone[0..1] String [0, 3]A three character code with the Time Zone of the merchant. For example, 'EDT', 'EST', 'CDT'
TransactionTime[0..1]HH: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.
ChannelCutoffTime[0..1]HH: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
CardEventType[0..1] String [0, 15]Event Type of the plastic card transaction. Valid values: Sale, Authorization, Force Credit, Void Sale, Void Credit
AuthorizationRequestResponseCode[0..1] String [0, 2]Indicates whether the transaction is approved or declined. If declined, it will indicate why it was declined.
PlasticTypeCode[0..1]CRT [Credit Card], DBT [Debit Card], EBT [Electronic Benefit Card], GFT [Gift Card]Indicates plastic medium used.
IsRecurring[0..1] 1|0Indicates if the item is a recurring transaction.
AdjustmentType[0..1] String [0, 10]Type of adjustment item.


For help, please contact the Treasury FMS Enterprise Data Architecture team.
Last Updated: 2012-06-28T19:02:15.453-04: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.