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.