Spectrum HBC BIN File

Document Sample
Spectrum HBC BIN File Powered By Docstoc
					Spectrum SDK Developers
Guide – HBC BIN File




                    V 1.1.0
                     9.30.09
Revision Summary

  Date     Version                      Description                 Author
 4/30/09    1.0.0    Initial Revision                              Scott Ring
 9/30/09    1.1.0    Updated with miscellaneous documentation      Scott Ring
                     updates




                        Spectrum Developers Guide - HBC BIN File                Page ii
Table of Contents
INTRODUCTION ..........................................................................................................................1
Using Spectrum to Retrieve the HBC Bin Files........................................................................2
  Retrieval in Intranet Mode (Frame/VPN Communication).........................................................2
  Retrieval in Internet Mode (SFTP Communication) ..................................................................2
  Processing HBC BIN file ...........................................................................................................2
HEADER RECORD ......................................................................................................................3
HEALTH CARD BENEFITS IIAS DETAIL RECORD...................................................................4
TRAILER RECORD......................................................................................................................6
APPENDIX: Tables ......................................................................................................................7
  I. Card Indicators.......................................................................................................................7
  II. Default Card Type.................................................................................................................7




                                              Spectrum Developers Guide - HBC BIN File                                              Page iii
INTRODUCTION
Process Overview   This technical specification document has been created to assist merchants in
                   identifying specific types of cards using a Health Card Benefits BIN Range File. It
                   contains all Visa, MasterCard BIN Ranges and can be imported directly into the
                   merchant’s processing system.

                   Chase Paymentech Solutions, LLC has an automated process that updates these
                   files on a daily basis. The BIN ranges provided are only those, which are active at
                   the time the file is created.

                   The Health Benefits Card BIN range file consists of all Visa and MasterCard
                   ranges provided to Chase Paymentech at the time the file is created. Chase
                   Paymentech is not responsible for errors or omissions.

                   The default file name is HBINP.V001.mmddyyyy.*, where the * could be F (fixed),
                   T (Tab), P (Pipe), C (Comma)
                   Each record should have a line feed [↵] (hex 0A) in position 97.

                   If you have any questions regarding the Health Benefit Card BIN Range file or
                   transaction processing in general, please contact your Chase Paymentech
                   Representative.


Request For        The RFR Record is a Request For Response record that enables merchants and
Response Files     vendors to connect to Chase Paymentech systems to retrieve the HBC BIN
                   file(s).

                   This option is used only in Frame/VPN communication

                   Notes: If an RFR record is received by Chase Paymentech, and there is no file
                   available for pick up, a null ResponseDescriptor object is returned by the
                   Spectrum SDK.

                   If the file needs to be retrieved a second time, call Chase Paymentech
                   Operations to have the file re-approved for pick up.


File Naming        The HBC BIN files are stored in client system in an AES encrypted format in the
Convention         path specified under the <Incoming> directory of config.xml. The following syntax
                   is used in naming:

                   HBCBIN<Date as mm-dd-yy format>_<time as hh.mm.ss>.response

                   ResponseDescriptor.FileName property return the HBC BIN file name as stored
                   in the client system




                               Spectrum Developers Guide - HBC BIN File                          Page 1
Using Spectrum to Retrieve the HBC Bin Files

Retrieval in Intranet Mode (Frame/VPN Communication)

Use the appropriate RFR request in the ReceiveResponse() function to receive the HBC BIN file as would
be done for the regular batch response retrieval process.

Retrieval in Internet Mode (SFTP Communication)

Use ResponseType.HBCBIN response type in the ReceiveResponse() function to receive the
HBC BIN file like the batch response retrieval process.

If no HBC BIN file is available an empty ResponseDescriptor is returned. The FileName property of
ResponseDescriptor return the name used in naming the HBC BIN file (AES encrypted) in client system.

Processing HBC BIN file

Once the file is received, use the GetNextParsedRecord() function in conjunction with
HasNextRecord from the ResponseDescriptor object to read each record from the HBC BIN file.

GetNextParsedRecord() will return a Response object which represents each HBC BIN record as a XML
object. Each response object has a “RecordType” field as a common field which identifies each record to
a specific type of record like Header, Detail & Trailer Record. Once the record is identified, use the field
name from that specific record type to access the data from the response object.

Use Response.RawData to get the record as a delimited record (as stored in the HBC BIN file)




                                    Spectrum Developers Guide - HBC BIN File                           Page 2
HEADER RECORD
Field Name      Comments                                Length   Data
                                                                 Type
RecordType      Constant “00000000”                     8           N

FileName        Constant “HBCBINP”                      10         A

                Notes: “HBCBINT” will be used
                for test files.
Version         Constant “V001”                         4          A

CreationDate    MMDDYYYY format                         8          N




                 Spectrum Developers Guide - HBC BIN File               Page 3
HEALTH CARD BENEFITS IIAS DETAIL RECORD
                                                                                 Data
Field Name                      Comments                                Length   Type
RecordType                      “D” Constant                              1       A
BINLow                          Low end of BIN Range – Minimum           19       N
                                account number in BIN Range

BINHigh                         High end of BIN Range – Maximum          19       N
                                account number in BIN Range

PrimaryAccountNumberLength      Length of account number within           2       N
                                the BIN Range.

CardProduct                     Valid Values:                             1       A
                                  M = MasterCard
                                  V = Visa


CardIndicator                   Left justified/blank filled               2       A

                                Note: See Appendix – Table I,
                                Card Indicators
DefaultCardType                 Valid Value:                              2       A
                                U = Health Card




                             Spectrum Developers Guide - HBC BIN File                   Page 4
                    HEALTH CARD BENEFITS IIAS DETAIL RECORD
                                                  (Continued)
                                                                          Data
Field Name      Comments                                         Length   Type
BINUpdateDate   YYMMDD format                                      6       N




                      Spectrum Developers Guide - HBC BIN File                   Page 5
TRAILER RECORD

                                                                             Data
Field Name           Comments                                       Length   Type
RecordType           Constant “99999999”                              8       N
CreationDate         MMDDYYYY format                                  8       N
NumberOfBINRecords   Total number of BIN records within               8       N
                      this file




                         Spectrum Developers Guide - HBC BIN File                   Page 6
APPENDIX: Tables

The Card Indicators table specifies if the card is a credit, debit.

I. Card Indicators


   Indicators         Card Issue Type                     Description
       P                   Debit           Pin Debit Only Without EBT
       E                   Debit           Pin Debit Only With EBT
       H                   Debit           Debit Card (PIN Capable)
       C                   Credit          Credit Card (PIN Capable)
       S                   Debit           Debit Card (No PIN)
       X                   Credit          Credit Card (No PIN)



II. Default Card Type


                    Visa                                                      MasterCard
U = Health Benefits Card                                    U = Health Benefits Card




                                     Spectrum Developers Guide - HBC BIN File              Page 7

				
DOCUMENT INFO
Shared By:
Categories:
Tags: chase, credit, cards
Stats:
views:81
posted:3/11/2011
language:English
pages:10