Aadhaar Payment Bridge System(APBS) File Format Specifications. Version 1.2

Transcription

1 Aadhaar Payment Bridge System(APBS) File Format Specifications

2 APBS Input File Preparation Submission Input Media Data in below mentioned format to be uploaded on the identified web-server File Preparation The output file would have two types of data records-: a large number of INVIDUAL records (transaction code- 77 for Credit) and one balancing record called HEADER (transaction code - 33). The HEADER record would be the first record in the file and contain the details of the User such as User No., User name, Sponsor Bank sort code, the upper limit of the individual entry, the total value of all the individual items, etc. which would act as control information while processing the individual records. Certain key information in the HEADER record would be repeated in the individual records as well so as to make individual record selfcontained with both credit and debit particulars of the transaction. The following is the description of the various fields for preparing the data on input file in ASCII format: Pre-requisite for Input File preparation APB Credit file transaction codes can be defined as below. Sr. No. Item Transaction Code 1 Sponsor Bank Input File Header 33 2 Sponsor Bank Input File Individual Record 77

3 Data to be uploaded by Sponsor Bank to NPCI Header Record Sr.No Field Name Length Field Type Status Field Description Position Remarks 1 APBS Transaction Code 2 NUM M APBS transaction code 33 for APBS credit. 2 User 7 ALP / NUM M User allotted by NPCI User Name 40 ALP / NUM M 4 User Reference 14 ALP / NUM M 5 APBS Tape Input Name of Government Department / Agency / User User defined reference number for entire transaction As defined in the prerequisites for Input file preparation First two digits state code followed by 5 digit scheme code TWAD,Board Chennai -5. Remaining field length has been filled with spaces on the right T NUM O User defined input tape Sponsor Bank IIN 9 NUM M 6 digit Sponsor Bank IIN Three spaces to the left have been padded with zeroes. 7 User's Bank Account number 15 ALP / NUM M Account number of user with sponsor bank Remaining field length has been filled with spaces on the right 8 Ledger folio number 3 ALP / NUM O Ledger folio particulars spaces, not in use currently however can be used as per sponsor bank requirements.

4 9 User defined limit for individual credit items 13 NUM O User defined limit which would be taken to validate individual items amount , there is no limit currently, however can be used if limits prescribed by Government Department or Sponsor Bank. 10 Total items 9 NUM M Total items in the file This should be left padded with 0 s. 11 Total amount (Balancing debit items) 13 NUM M Amount in paise , left padded with zeroes Settlement date (DDMMYYYY) Reserved (Kept blank by user) Reserved (Kept blank by user) 8 NUM M 10 NUM O 10 NUM O Date on which settlement is to be effected APBS item sequence number to be allotted by NPCI Checksum total generated by NPCI spaces spaces 15 Filler 3 ALP / NUM O spaces Total 165

5 Individual Record Sr.No Field Name Length Field Type Status Field Description Position Remarks 1 APBS Transaction Code 2 NUM M 2 Destination Bank IIN 9 NUM O Transaction code 77 for APBS credit. 6 digit Destination Bank IIN 3 Destination Account Type 2 NUM O 10/ Ledger Folio 3 ALP / NUM O 5 Beneficiary Aadhaar 15 NUM M Alphanumeric ledger folio particulars Beneficiary's 12 digit Aadhaar As defined in the pre-requisites for Input file preparation Left padded with zeroes. This field could be left blank by the sponsor bank as the APBS mapper has capability to populate this field SB account / 11 - Current account Alphanumeric ledger folio particulars, else padded with spaces Aadhaar No. being of 12 digits, field will be left padded with three zeroes. 6 Beneficiary account holder's name 40 ALP / NUM O Beneficiary's account name Sponsor Bank IIN 9 NUM M 6 digit Sponsor Bank IIN User number 7 ALP / NUM M 9 User Name 20 ALP / NUM M Name of Government Department / Agency User number allotted by NPCI POONKUZHALI.K. Remaining filed length has been filled with spaces on the right Left padded with zeroes. First two digits state code followed by 5 digit scheme code TWAD Board, Chennai-5. Right padded with spaces.

6 10 User Credit reference 13 ALP / NUM M User defined reference number such as ledger folio number, share/debenture certificate number or any other unique identification number given by user to individual beneficiaries Amount 13 NUM M Amount in Paise / Right padded with spaces Left padded with zeroes. 12 Reserved (Kept blank by user) 10 NUM O APBS item sequence number to be allotted by NPCI spaces Reserved (Kept blank by user) Reserved (Kept blank by user) 10 NUM O 1 NUM O 15 Filler 2 NUM O Checksum total generated by NPCI Flag for items credited (1) and returned uncredited (0) Reason for not crediting the item spaces space spaces 16 Filler 9 NUM O To be used later spaces Total 165

7 APBS RECORD LAYOUT OF THE OUTPUT DATA FOR DESTINATION BANKS NPCI to Destination Banks Header Record Sr.No Field Name 1 APBS Transaction Code Length Field Type 2 NUM M Status Field Description For APBS credit transaction code 33 for header. Position Remarks 2 Control Character 7 NUM O Zeroes 3-9 seven zeroes 3 Filler 87 ALP / NUM O Filler Spaces 4 Control Character 7 NUM O Six digit Destination Bank IIN left padded with a zero As defined in the pre-requisites for Input file preparation , left padded with a zero. Currently not used, this can be used as required by Government Department or Sponsor Bank. 5 Total number of items 9 NUM M Total number of items , Left padded with 0 s 6 Total amount 13 NUM M 7 Settlement date (DDMMYYYY) 8 Filler 44 Total NUM M ALP / NUM O Total amount in the file Settlement date in ddmmyyyy format Filler and ends with a dot , left padded with zeroes spaces and a dot in end

8 Individual Record Sr.No Field Name Length Field Type Status Field Description Position Remarks 1 APBS Transaction Code 2 NUM M Transaction code 77 for APBS credit. 2 Destination Bank IIN 9 NUM M 6 digit Destination Bank IIN Destination Account Type Ledger Folio Beneficiary Aadhaar 2 NUM O 10/ ALP / NUM O 15 ALP / NUM M Alphanumeric ledger folio particulars Beneficiary's 12 digit Aadhaar As defined in the pre-requisites for Input file preparation , left padded with three zeroes SB account / 11 - Current account Alphanumeric ledger folio particulars, else padded with spaces Aadhaar No. being of 12 digits, field will be left padded with three zeroes. 6 Beneficiary account holder's name 40 ALP / NUM O Beneficiary's account name Sponsor Bank IIN 9 NUM M 6 digit Sponsor Bank IIN User number 7 ALP / NUM M 9 User Name 20 ALP / NUM M User number allotted by APBS authority Name of Government Department / Agency R.DEVANATHAN Remaining field length has been filled with spaces on the right Three spaces to the left have been padded with zeroes. First two digits state code followed by 5 digit scheme code TWAD Board, Chennai-5. Right padded with spaces.

9 10 User Credit reference 13 ALP / NUM M User defined reference number such as ledger folio number, share/debenture certificate number or any other unique identification number given by user/service provider to individual beneficiaries / Right padded with spaces. 11 Amount 13 NUM M Amount in Paisa Reserved (Kept blank by user) Reserved (Kept blank by user) Reserved (Kept blank by user) Destination bank account number 10 NUM O 10 NUM O 2 NUM O 20 ALP/NUM O 16 Return reason code 2 ALP/NUM O Total 177 APBS item sequence number to be allotted by NPCI Checksum total generated by NPCI Flag for items credited (1) and returned uncredited (0) In case the transaction is successful this should be populated In case the transaction is returned this should be populated spaces spaces spaces Left padded with Zeroes Pad it right with spaces Pad it with spaces in case it is null

10 RECORD LAYOUT OF THE RETURN / SUCCESS FILE Destination Banks to NPCI This is the file generated by the destination banks for all items received. The banks will send all items back along with the destination bank account and the name of the beneficiary. For returned items these 2 fields will not have any value and the reason code will be populated with the reason for return.this file will have the header record as well as detail record. The header record is as follows. Header Record Sr.No Field Name 1 APBS Transaction Code Length Field Type 2 NUM M Status Field Description For APBS credit transaction code 33 for header. Position Remarks 2 Control Character 7 NUM O Zeroes 3-9 seven zeroes 3 Filler 87 ALP / NUM O Filler Spaces 4 Control Character 7 NUM O Six digit Destination Bank IIN left padded with a zero As defined in the pre-requisites for Input file preparation , left padded with a zero. Currently not used, this can be used as required by Government Department or Sponsor Bank. 5 Total number of items 9 NUM M Total number of items , left padded with 0 s

11 6 Total amount 13 NUM M Total amount in the file , left padded with zeroes. 7 Settlement date (DDMMYYYY) 8 NUM M Settlement date in ddmmyyyy format Filler 44 ALP / NUM O Filler and ends with a dot spaces and a dot in end Total 177 The detail record will be as follow Sr.No Field Name Length Field Type Status Field Description Position Remarks 1 APBS Transaction Code 2 NUM M Transaction code 77 for APBS credit. 2 Destination Bank IIN 9 NUM M 6 digit Destination Bank IIN Destination Account Type Ledger Folio Beneficiary Aadhaar 2 NUM O 10/ ALP / NUM O 15 ALP / NUM M Alphanumeric ledger folio particulars Beneficiary's 12 digit Aadhaar As defined in the pre-requisites for Input file preparation , left padded with three zeroes SB account / 11 - Current account Alphanumeric ledger folio particulars, else padded with spaces Aadhaar No. being of 12 digits, field will be left padded with three zeroes. 6 Beneficiary account holder's name 40 ALP / NUM O Beneficiary's account name Sponsor Bank IIN 9 NUM M 6 digit Sponsor Bank IIN R.DEVANATHAN Remaining field length has been filled with spaces on the right Three spaces to the left have been padded with zeroes.

12 8 User number 7 ALP / NUM M User number allotted by APBS authority First two digits state code followed by 5 digit scheme code 9 User Name 20 ALP / NUM M Name of Government Department / Agency TWAD Board, Chennai-5. Right padded with spaces. 10 User Credit reference 13 ALP / NUM M User defined reference number such as ledger folio number, share/debenture certificate number or any other unique identification number given by user/service provider to individual beneficiaries / Right padded with spaces. 11 Amount 13 NUM M Amount in Paisa Reserved (Kept blank by user) Reserved (Kept blank by user) Reserved (Kept blank by user) Destination bank account number 10 NUM O 10 NUM O 2 NUM O 20 ALP/NUM O 16 Return reason code 2 ALP/NUM O Total 177 APBS item sequence number to be allotted by NPCI Checksum total generated by NPCI Flag for items credited (1) and returned uncredited (0) In case the transaction is successful this should be populated In case the transaction is returned this should be populated spaces spaces spaces Left padded with Zeroes Pad it right with spaces Pad it with spaces in case it is null

13 Listing of Return Reason Code The following return reason codes will be considered for return clearing, the responsibility of Destination Banks towards returns clearing will be as described under Role and Responsibilities of Destination Bank. Sr. No Return Reason Code Description 1 01 Account closed or transferred 2 02 No such Account 3 03 No such Aadhaar No Aadhaar No invalid 5 05 Account no or Aadhaar No does not pertain to the bank 6 06 Miscellaneous ( to be described)

14 RECORD LAYOUT OF THE FINAL OUTPUT FILE NPCI to Sponsor Bank Record Layout of the Final Status File (from NPCI to Sponsoring Bank) This is the file generated by NPCI and sent to the Sponsor bank. One file will be generated for each of the input files received from the sponsor bank. So the total number of output files will be equal to the total number of input files received from a sponsor bank. The file has two types of data records, viz., one header record called the contra record and the repetitive records. The following table gives the details of the fields and their length of the contra record and the repetitive records. Pre-requisites for NPCI to Sponsor Bank Response file The transaction codes for Sponsor Bank response file can be defined as below. Sr. No. Item Transaction Code 1 NPCI to Sponsor Bank Output File Header NPCI to Sponsor Bank Output File Individual Record Successful transaction NPCI to Sponsor Bank Output File Individual Record Uncredited transaction 77 88

15 Header Record Sr. No 1 Field Description APBS transaction Code Length Field Type 2 NUM M 2 User 7 NUM M 3 User name 40 ALP M 4 User Credit Reference 14 ALP / NUM Status Field Description Position Remarks M APBS - Credit transaction code 33 User number to be allotted by NPCI. Name of the Government Department / Agency User defined reference number for the entire transaction (Alpha Numeric) APBS tape input 9 NUM O User defined input tape Sponsor Bank IIN 9 NUM M BIN / IIN allocated by NPCI. This is 6 digits. hence to be left padded with three zeros As defined in the pre-requisites for Sponsor Bank Output file preparation First two digits state code followed by 5 digit scheme code TWAD,Board Chennai - 5.Remaining field length has been filled with spaces on the right T , right padded with zeroes , Currently not used however can be used as per requirements of Government Department or Sponsoring Banks , left padded with three zeroes. 7 User s bank Account number 15 ALP / NUM M Account number of the User to be debited by Sponsor Bank. (Alpha numeric) Remaining field length right padded with spaces 8 Ledger Folio number 3 ALP O Alpha numeric Ledger Folio particulars blank spaces, Currently not used, however can be used as per requirements from Government Departments.

16 9 User defined limit for individual credit items 13 NUM O User defined limit which would be taken for validating the individual items (in paise) , Currently no limit is imposed on transaction level processing, however the same can be considered if required by Government Departments or Sponsoring Banks. 10 Total items 9 NUM M Total number of items Left pad with 0 s Total amount (Balancing Debit amount) Settlement date (DDMMYYYY) 13 NUM M Amount in paise NUM M Effected Date of Settlement, as desired by Government Departments , left padded with zeroes. 12 Item Sequence 10 NUM M APBS Item Sequence number generated by NPCI To be Generated by NPCI 13 Checksum 10 NUM M Checksum generated by NPCI To be Generated by NPCI 14 Filler 15 NUM O Filler blank spaces Total 177

17 Individual Records Sr.No Field Name Length Field Type Status Field Description Position Remarks 1 APBS Transaction Code 2 NUM M 2 Destination Bank IIN 9 NUM M Transaction code 77 for APBS credit. 6 digit Destination Bank IIN 3 Destination Account Type 2 NUM O 10/ Ledger Folio 3 ALP / NUM O 5 Beneficiary Aadhaar 15 NUM M Alphanumeric ledger folio particulars Beneficiary's 12 digit Aadhaar As defined in the pre-requisites for Input file preparation Left padded with zeroes SB account / 11 - Current account Alphanumeric ledger folio particulars, else padded with spaces Aadhaar No. being of 12 digits, field will be left padded with three zeroes. 6 Beneficiary account holder's name 40 ALP / NUM O Beneficiary's account name Sponsor Bank IIN 9 NUM M 6 digit Sponsor Bank IIN User number 7 ALP / NUM M 9 User Name 20 ALP / NUM M 10 User Credit reference 13 ALP / NUM M Name of Government Department / Agency User number allotted by NPCI User defined reference number such as ledger folio number, share/debenture certificate number or any other unique identification number given by user to individual beneficiaries POONKUZHALI.K. Remaining filed length has been filled with spaces on the right Left padded with zeroes. First two digits state code followed by 5 digit scheme code TWAD Board, Chennai-5. Right padded with spaces. 000/ Right padded with spaces.

18 11 Amount 13 NUM M Amount in Paise Left padded with zeroes. 12 Item sequence 10 NUM O APBS item sequence number to be allotted by NPCI spaces 13 Checksum 10 NUM O Checksum total generated by NPCI Checksum total as generated by NPCI 14 Success Flag 1 NUM O Flag for items credited (1) and returned Flags as suggested by NPCI uncredited (0) 15 Filler 1 NUM O Used for internal purpose Padded with spaces 16 Reason Code 2 ALP/NUM O 17 Destination Bank account number Total ALP/NUM O Reason for not crediting the item If the transaction is successful this should be populated Reason code as defined. If the reason code is null pad it with spaces Pad it with spaces to the right