Online Debit API Fields

Field Name Length
Type		 Description
0001 Transaction Type 2
numeric		 REQUIRED. Must be included in all input API files. Determines what action Fusebox will perform with the data presented in the API input file.
Ex.: 0001,02
0002 Transaction Amount 4 - 8
cents		 Total amount for the transaction including tax and gratuity. Minimum of four characters, decimal point included (i.e., 1.00). Maximum amount including decimal is 99999.99 for any transaction.
0003 Account Number 128, 22
alphanumeric		 128 A/N on Input, 22 A/N on response and all transactions past the initial Input Request. Contains either the unformatted track swipe or the manually‐entered account number on the first input request. If magnetically read, the swipe data should be unaltered as read by the swipe. Output responses and future input requests reference the transaction with the Token. The format for API Field 0003 Token is: ID:################### No spaces in the entire field for a total length of 22. It is against card association regulations to store track data. The Token is returned in API Field 0003. The POS application will store the Token and pass this value on all successive transactions until the transaction has been successfully settled. If using Simplify, this field can be left blank and the Account Number will be input by the terminal device.
0006 Auth Code 6
alphanumeric		 Code returned from the card issuer or authorizing institution indication an approved. Valid Authorization Codes include ‘ ‘ (space)
0007 Reference Number 1-8
numeric		 Unique number supplied by the POS to identify the transaction within a batch/processing period. This number must be unique within a settlement batch.
0009 Batch Number 1-8
numeric		 Incrementing number that identifies the batch number. A batch number may not be available under some processor specifications. In this situation, the Fusebox keeps an internal number and presents it in every output file.
0017 Cash Back 4‐9
numeric		 Amount of cash back included in the amount API Field 0002. Conditional. Required for SVS virtual cards only.
0018 Debit PIN Block 16
alphanumeric		 Value = 1234, Conditional. Required for SVS virtual cards only.
0019 Key Serial Number 1-20
alphanumeric		 Check value used to verify PIN block encryption during DUKPT debit processing. Refer to your TPP for any special considerations.
0020 Surcharge Amount 4-8
cents		 Any additional amount included in the Total Amount (Field 002) added as a debit processing charge (ATM fees). Refer to your TPP for any special considerations.
0021 Network ID 1-20
alphanumeric		 Identifies debit network issuing authorization. Refer to your TPP for any special considerations.
0022 Debit Authentication Code 1-10
alphanumeric		 Used during debit transactions occurring outside U.S. (NDC). Used to verify debit network access. Refer to your TPP for any special considerations.
0023 Debit Account Type 2
numeric		 Type of debit account used. 00=Checking (default) 01=Savings 02=Other. Refer to your TPP for any special considerations.
0025 Business Date 6
numeric		 Used to control business date in Fusebox. For POS applications that process transactions where the end of day may cross over dates, this field can be used to keep one day’s business as defined by the POS Application consistent.
0032 Original Auth Date 6
date		 Date the original authorization transaction took place. Format: MMDDYY
0033 Original AuthTime 6
time		 Time the original authorization transaction took place. Format: HHMMSS
0034 Authorization Characteristics Indicator 1
alphanumeric		 Code that is used to track participation status of this transaction in interchange rate programs.
0037 Validation Code 1
alphanumeric		 Computed value assigned by the card association (Visa, MasterCard, etc) and used to verify data integrity between authorization and settlement.
0038 Reason Code 1‐2
alphanumeric		 Code assigned by some third party processors to track why a transaction was rated as it was.
0040 Compliance Data 1
alphanumeric		 Contains the indicator returned by issuing bank to indicate the result of the CVV2 (Visa), CVC2 (MasterCard) or CID (Amex) verification. See the CVV2/CVC2/CID section for more information. May be used by the POS application or cashier to evaluate the risk associated with a manually keyed transaction.
0042 Compliance Data 1-6
alphanumeric		 Code assigned by the credit card issuing bank to the transaction.
0043 System Trace Audit Number 6
numeric		 The System Trace Audit Number (STAN) is a unique number generated and used by the processor to track a transaction through its system. It is often the “key” field used by the processor to lookup a previous transaction when a Time Out Reversal is requested. Many Gift Card and Debit processors require the STAN to be printed on the receipt. If in Output Response, may be required to print on receipts.
0105 Data Files Path 1-28
alphanumeric		 Contains the directory path where Fusebox is installed on the system.
0106 Batch File Path 1-26
alphanumeric		 Directory path and file name where the Fusebox settlement file is located.
0107 Report File Path 1-80
alphanumeric		 Contains the directory path and file name for the Fusebox settlement report.
0108 History File Path 1-80
alphanumeric		 Contains the directory path to where history files are to be archived.
0109 Terminal ID 1-8
alphanumeric		 References a terminal defined in PbConfig.cfg that lets Fusebox know which processor to dial, what phone # to use, and which merchant information to access. In Fusebox, a single terminal can be used to process multiple methods of payment and MKey definitions.
0110 Cashier ID 1-8
alphanumeric		 Can contain any code or name up to 7 characters to identify the person running the POS.
0115 Transaction Qualifier 3
numeric		 Determines type of account used. 030=Debit All transactions must pass a transaction qualifier. The Transaction Qualifier must correspond to the Transaction Qualifier identified in the Fusebox Configuration, Card Types. This field may be left blank and the Transaction Qualifier input by the peripheral device for the Method of Payment selected by the cardholder.
0125 Compliance Data 1-15
alphanumeric		 Assigned for chargeback retrieval purposes May be required on receipt.
0126 Compliance Data 1
numeric		 Indicator showing how card was presented on original authorization:
00=Manual,
01=track1
02 = track2
This value can optionally be stored in the POS application to provide to the user how the original transaction was presented (Manual, or Swiped (track 1 or 2).
0127 Compliance Data 1
alphanumeric		 Any additional, non‐standard data the processor requires to be tracked for CPS compliance.
0128 CPS Original Authorization Amount 4-8
cents		 Requested Amount (0.00 – 99999.99)
0130 CPS Total Authorized Amount 4-8
cents		 Approved Amount (0.00 – 99999.99)
0131 CPS Total Incremental Auths Sent 2
numeric		 This is the total number of incremental auths that were sent within a batch settlement.
1000 Card Type 2
alphanumeric		 Two‐character card abbreviation defined in pbconfig.cfg
1001 Card Name 1-26
alphanumeric		 Full card name defined in pbconfig.cfg. May be printed on receipts (either API Field 1000 or 1001 must be printed on receipts). May be associated to the Token to allow the POS application to know what type of payment is associated with the transaction.
1003 Fusebox Response Code 1-4
numeric		 Code generated by the Fusebox to indicate its state when exiting. Governs internal error messages parsed from pberrors.txt and displayed in API Field 1010 and/or host messages displayed in API Field 1004. See General Information for Reviewing Response Fields.
1004 Host Response Message 1-80
alphanumeric		 Host response message, either verbatim or evaluated. May contain a Fusebox error message.
1005 Merchant Number 1-30
alphanumeric		 Merchant number from the merchant file. Must be printed on receipt.
1009 Host Response Code 1-10
alphanumeric		 Host response code indicating the condition of the transaction (both authorization and settlement).
1010 Fusebox Response 1-80
alphanumeric		 Fusebox response message corresponding to the error code returned in API Field 1003.
1011 Host Reference Number 1-8
alphanumeric		 Reference number assigned by the host processor to track this transaction. This is both an input AND output field. If returned in the Output Response, it must be printed on the receipt.
2010 Total Debit Card Sales Count 4
numeric		 Total net debit card sale transaction count. (Sales ‐ Void Sales).
2011 Total Debit Card Sales Amount 12
cents		 Net total debit card sale transaction amount. (Sales ‐ Void Sales).
2014 Total Debit Card Void Count 4
numeric		 Net total debit card void count.
2015 Total Debit Card Void Amount 12
cents		 Net total debit card void amount.
2018 Total Debit Card Return Count 4
numeric		 Net total debit card return count.
2019 Total Debit Card Return Amount 4
cents		 Net total debit card return amount.