Aadhaar Payment Bridge System(APBS) File Format Specifications
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
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 3-9 3 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 1-2 10-49 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 50-63 T02 38050 7611 9 NUM O User defined input tape 64-72 40520111 6 Sponsor Bank IIN 9 NUM M 6 digit Sponsor Bank IIN 73-81 000508505. 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 82-96 4181.Remaining field length has been filled with spaces on the right 8 Ledger folio number 3 ALP / NUM O Ledger folio particulars 97-99 3 spaces, not in use currently however can be used as per sponsor bank requirements.
9 User defined limit for individual credit items 13 NUM O User defined limit which would be taken to validate individual items amount 100-112 0000017500000, 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 113-121 This should be left padded with 0 s. 11 Total amount (Balancing debit items) 13 NUM M Amount in paise 122-134 0000181308700, left padded with zeroes. 12 13 14 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 135-142 7052011 143-152 10 spaces 153-162 10spaces 15 Filler 3 ALP / NUM O 163-165 3 spaces Total 165
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/11 12-13 4 Ledger Folio 3 ALP / NUM O 5 Beneficiary Aadhaar 15 NUM M Alphanumeric ledger folio particulars Beneficiary's 12 digit Aadhaar 1-2 3-11 14-16 16-31 As defined in the pre-requisites for Input file preparation 000508507. Left padded with zeroes. This field could be left blank by the sponsor bank as the APBS mapper has capability to populate this field. 10 - SB account / 11 - Current account Alphanumeric ledger folio particulars, else padded with spaces 000999957150526. 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 32-71 7 Sponsor Bank IIN 9 NUM M 6 digit Sponsor Bank IIN 72-80 8 User number 7 ALP / NUM M 9 User Name 20 ALP / NUM M Name of Government Department / Agency User number allotted by NPCI 81-87 88-107 POONKUZHALI.K. Remaining filed length has been filled with spaces on the right 000508505. Left padded with zeroes. First two digits state code followed by 5 digit scheme code 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 to individual beneficiaries 108-120 11 Amount 13 NUM M Amount in Paise 121-133 000/ 23000511. Right padded with spaces. 0000000490000. Left padded with zeroes. 12 Reserved (Kept blank by user) 10 NUM O APBS item sequence number to be allotted by NPCI 134-143 10 spaces 13 14 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 144-153 10 spaces 154 1 space 155-156 2 spaces 16 Filler 9 NUM O To be used later 157-165 9 spaces Total 165
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 10-96 87 Spaces 4 Control Character 7 NUM O Six digit Destination Bank IIN left padded with a zero. 1-2 97-103 As defined in the pre-requisites for Input file preparation 0508507, 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 104-112 000000123, Left padded with 0 s 6 Total amount 13 NUM M 7 Settlement date (DDMMYYYY) 8 Filler 44 Total 177 8 NUM M ALP / NUM O Total amount in the file Settlement date in ddmmyyyy format Filler and ends with a dot 113-125 126-133 7052011 0000000490000, left padded with zeroes. 134-177 43 spaces and a dot in end
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 3-11 3 4 5 Destination Account Type Ledger Folio Beneficiary Aadhaar 2 NUM O 10/11 12-13 3 ALP / NUM O 15 ALP / NUM M Alphanumeric ledger folio particulars Beneficiary's 12 digit Aadhaar 1-2 14-16 17-31 As defined in the pre-requisites for Input file preparation 000508507, left padded with three zeroes. 10 - SB account / 11 - Current account Alphanumeric ledger folio particulars, else padded with spaces 000999957150526. 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 32-71 7 Sponsor Bank IIN 9 NUM M 6 digit Sponsor Bank IIN 72-80 8 User number 7 ALP / NUM M 9 User Name 20 ALP / NUM M User number allotted by APBS authority Name of Government Department / Agency 81-87 88-107 R.DEVANATHAN Remaining field length has been filled with spaces on the right 000508505. 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.
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 108-120 002/ 97400511. Right padded with spaces. 11 Amount 13 NUM M Amount in Paisa 121-133 12 13 14 15 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 134-143 10 spaces 144-153 10 spaces 154-155 1 spaces 0000000369200. Left padded with Zeroes. 156-175 Pad it right with spaces 176-177 Pad it with spaces in case it is null
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 10-96 87 Spaces 4 Control Character 7 NUM O Six digit Destination Bank IIN left padded with a zero. 1-2 97-103 As defined in the pre-requisites for Input file preparation 0508507, 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 104-112 000000123, left padded with 0 s
6 Total amount 13 NUM M Total amount in the file 113-125 0000000490000, left padded with zeroes. 7 Settlement date (DDMMYYYY) 8 NUM M Settlement date in ddmmyyyy format 126-133 7052011 8 Filler 44 ALP / NUM O Filler and ends with a dot 134-177 43 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 3-11 3 4 5 Destination Account Type Ledger Folio Beneficiary Aadhaar 2 NUM O 10/11 12-13 3 ALP / NUM O 15 ALP / NUM M Alphanumeric ledger folio particulars Beneficiary's 12 digit Aadhaar 1-2 14-16 17-31 As defined in the pre-requisites for Input file preparation 000508507, left padded with three zeroes. 10 - SB account / 11 - Current account Alphanumeric ledger folio particulars, else padded with spaces 000999957150526. 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 32-71 7 Sponsor Bank IIN 9 NUM M 6 digit Sponsor Bank IIN 72-80 R.DEVANATHAN Remaining field length has been filled with spaces on the right 000508505. Three spaces to the left have been padded with zeroes.
8 User number 7 ALP / NUM M User number allotted by APBS authority 81-87 First two digits state code followed by 5 digit scheme code 9 User Name 20 ALP / NUM M Name of Government Department / Agency 88-107 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 108-120 002/ 97400511. Right padded with spaces. 11 Amount 13 NUM M Amount in Paisa 121-133 12 13 14 15 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 134-143 10 spaces 144-153 10 spaces 154-155 2 spaces 0000000369200. Left padded with Zeroes. 156-175 Pad it right with spaces 176-177 Pad it with spaces in case it is null
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. 4 04 Aadhaar No invalid 5 05 Account no or Aadhaar No does not pertain to the bank 6 06 Miscellaneous ( to be described)
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 33 2 3 NPCI to Sponsor Bank Output File Individual Record Successful transaction NPCI to Sponsor Bank Output File Individual Record Uncredited transaction 77 88
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). 1-2 3-9 10-49 50-63 5 APBS tape input 9 NUM O User defined input tape 64-72 6 Sponsor Bank IIN 9 NUM M BIN / IIN allocated by NPCI. This is 6 digits. hence to be left padded with three zeros 73-81 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 T02 38050 7611, right padded with zeroes. 40520111, Currently not used however can be used as per requirements of Government Department or Sponsoring Banks. 000508505, 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) 82-96 4181.Remaining field length right padded with spaces 8 Ledger Folio number 3 ALP O Alpha numeric Ledger Folio particulars 97-99 3 blank spaces, Currently not used, however can be used as per requirements from Government Departments.
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) 100-112 0000017500000, 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 113-121 Left pad with 0 s 10 11 Total amount (Balancing Debit amount) Settlement date (DDMMYYYY) 13 NUM M Amount in paise 122-134 8 NUM M Effected Date of Settlement, as desired by Government Departments. 135-142 7052011 0000181308700, left padded with zeroes. 12 Item Sequence 10 NUM M APBS Item Sequence number generated by NPCI 143-152 To be Generated by NPCI 13 Checksum 10 NUM M Checksum generated by NPCI 153-162 To be Generated by NPCI 14 Filler 15 NUM O Filler 163-177 15 blank spaces Total 177
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/11 12-13 4 Ledger Folio 3 ALP / NUM O 5 Beneficiary Aadhaar 15 NUM M Alphanumeric ledger folio particulars Beneficiary's 12 digit Aadhaar 1-2 3-11 14-16 16-31 As defined in the pre-requisites for Input file preparation 000508507. Left padded with zeroes. 10 - SB account / 11 - Current account Alphanumeric ledger folio particulars, else padded with spaces 000999957150526. 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 32-71 7 Sponsor Bank IIN 9 NUM M 6 digit Sponsor Bank IIN 72-80 8 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 81-87 88-107 108-120 POONKUZHALI.K. Remaining filed length has been filled with spaces on the right 000508505. Left padded with zeroes. First two digits state code followed by 5 digit scheme code TWAD Board, Chennai-5. Right padded with spaces. 000/ 23000511. Right padded with spaces.
11 Amount 13 NUM M Amount in Paise 121-133 0000000490000. Left padded with zeroes. 12 Item sequence 10 NUM O APBS item sequence number to be allotted by NPCI 134-143 10 spaces 13 Checksum 10 NUM O Checksum total generated by NPCI 144-153 Checksum total as generated by NPCI 14 Success Flag 1 NUM O Flag for items credited (1) and returned 154-154 Flags as suggested by NPCI uncredited (0) 15 Filler 1 NUM O Used for internal purpose 155-155 Padded with spaces 16 Reason Code 2 ALP/NUM O 17 Destination Bank account number Total 177 20 ALP/NUM O Reason for not crediting the item If the transaction is successful this should be populated 156-157 Reason code as defined. If the reason code is null pad it with spaces 158-177 Pad it with spaces to the right