AEPS Interface Specification v2.7 PDF
AEPS Interface Specification v2.7 PDF
AEPS Interface Specification v2.7 PDF
PAYMENT SYSTEM
INTERFACE SPECIFICATION
Documents Details
Author
Ruchir Asthana
Published Date
26-01-12
Version
2.7
55
Document classification
Confidential
Document History
Date
26-01-12
Version
2.7
Change
OFFUS ready Message dump & Receipt Format
Updated
Updated
Updated
Introduced
Prepared By:
Date
Ruchir Asthana
26-01-12
Reviewed By:
Mr. Ragavan Venkatesan
Mr. Mukesh Ranjan
Mr. Sateesh Palagiri
Mr. S M Nabar
Date
27-01-12
14-02-12
02-02-12
02-03-12
Approved By:
Mr. Dilip Asbe
Date
02-03-12
Page 2 of 55
Table Of Contents
1.0 Introduction ..................................................................................................................... 4
2.0 AADHAAR Implementation for FI Architecture .................................................................. 5
3.0 Changes for Member Banks as Acquirer and Issuers ........................................................ 34
4.0 Settlement and Reconciliation ........................................................................................ 35
5.0 Risk Management .......................................................................................................... 37
6.0 Exception Conditions ...................................................................................................... 38
7.0 Message Dump .............................................................................................................. 40
8.0 Transaction Receipt Format ............................................................................................ 52
9.0 Changes in v2.7 from v2.6.1 ............................................................................................ 55
Page 3 of 55
1.0 Introduction
1.1 Executive Summary
National Payments Corporation of India (NPCI) is formed as an umbrella institution for all the retail
payments systems in the country. The core objective is to consolidate and integrate the multiple systems
with varying service levels into nation-wide uniform and standard business process for all retail payment
systems. The other objective was to facilitate an affordable payment mechanism to benefit the common
man across the country and help financial inclusion. Vision and formation of NPCI is backed by the
regulator and Indian Banks Association (IBA). NPCI has defined business lines to process in country
interbank transactions for ATM, POS, 24*7 Remittance, ACH and CTS.
Government of India has initiated Unique Identification Project for citizens of India. It is envisaged to use
the UID schema and infrastructure for the financial inclusion in India. To enable the customers to use
AADHAAR for the financial transaction across the payment networks in the country, NPCI proposes to
facilitate routing of transactions to the central id repository of UIDAI for user authentication through a
single interface.
This interface document is targeted to achieve inter-operability between banks for AADHAAR enabled
financial inclusion transactions.
NPCI shall allow banks to connect using this interface. It is also possible that banks may position their
respective financial inclusion service provider to connect on their behalf to NPCI central infrastructure
with the complete onus with the respective member bank.
1.3 Audience
This document is a property of NPCI and should be not be circulated to external party without prior
approvals of NPCI management team.
Page 4 of 55
Page 5 of 55
Page 6 of 55
In case Bank desires to leverage NPCI AEPS interface for UIDAI authentication, the transaction flow given
above where the transaction for biometric verification will be sent for requisite fields and verification
result from UIDAI will be forwarded to the bank.
Page 7 of 55
The transaction flow is depicted above for funds transfer from account of customer of Remitter Bank to
Beneficiary Bank where the transaction is initiated on Remitter banks terminal. In fund transfer
transaction, remitter bank is the same as Issuer & Acquirer bank.
Online Debit and Online credit is envisaged in this transaction and beneficiary bank is expected to respond
with beneficiarys Aadhaar number and name in the response message.
Interchange fees as and when decided will be highlighted by NPCI along with Bio Metric verification from
UID system. It is assumed for fund transfer that only pre authorized transaction (credit leg) will come to
NPCI.
Page 8 of 55
It is necessary that for fund transfer transaction remitter will use its own bank MicroATMs / POS /
Infrastructure (i.e. Acquirer bank and Issuer bank is same in this case as is referred as Remitter Bank)
Fund transfer explained:
1. Fund transfer transaction consists of 2 legs i.e. debit leg and credit leg. It is important to note
that debit leg has to be processed locally and credit message to be sent to NPCI.
2. In order to facilitate debit leg, NPCI provides biometric authentication service.
3. Once a fund transfer transaction is initiated from a terminal, acquirer switch has to split the same
in two parts i.e. debit leg and credit leg. After processing the debit leg, credit leg is sent to NPCI.
For processing debit leg, NPCI provides authentication service where in only authentication
transaction has to be sent to NPCI and after the response of the same and debiting the sender
account; credit leg should be sent to NPCI. (Refer to message dump for authentication transaction
and fund transfer credit leg).
4. All fund transfer transactions will pre-authorized by the issuer i.e. after debiting the sender
account credit transaction will be sent to NPCI for processing.
If any member bank is taking authentication service from NPCI, then the fund transfer transactions will
be two-step process as explained below:
1. As shown in the above diagram (dotted line) authentication transaction will be initiated by the
acquirer for authentication and subsequent debit to the sender account. Please note that
authentication transaction is a non-financial transaction.
2. Once the debit to sender account is successful a remittance transaction is sent to NPCI.
3. The context of both authentication and fund transfer transaction will be maintained by the acquirer.
Page 9 of 55
NOTE:
1. In case of authentication request, DE2 should carry the remitters AADHAAR number (Sender AADHAAR
no.).
2. For credit leg data element DE2 will contain the beneficiary AADHAAR no., DE120 will contain the
sender AADHAAR No. and DE63 contains the biometric data of sender. It is the responsibility of issuer
to debit the senders account and send a fund transfer message to NPCI. The description of DE120 is
detailed in Data Element Definition section.
3. In case, acquirer receives any other Response Code than 00 or 91; the debit should be
reversed internally. In all other cases, disputes will be handled through Dispute Management
System (DMS) provided by NPCI.
4. As explained earlier fund transfer option is available to customer only at their home terminal. It is
only for those participants who are both acquirer and issuer.
Details - Off us flow Other transactions (Cash Withdrawal, Cash Deposit, Balance
Enquiry)
The transaction flow depicted above is for Balance Enquiry, Cash Withdrawal and Cash Deposit
transactions acquired on Acquirer bank terminal for Issuer bank customers. Interchange fees will be
highlighted by NPCI along with Bio Metric verification from UIDAI system after only the decision being
mutually taken between the banks and concerned regulatory bodies.
Page 10 of 55
Bank needs to send auto logon (network) message when there is a disruption or disconnection
in network before sending the financial transaction message.
Page 11 of 55
NPCI
NPCI must be able to receive and process message containing DE-2, DE-63, DE120 and DE 127
Recipient
The Recipient must be able to receive and process messages containing DE-2, DE-22, DE-62 and
DE120.
It is up to the recipient how to interpret and use the values transferred in DE-22 & DE-120.
It must send current account balance of customer in DE 54 for all transactions. Data Received
in DE-62 is the Unique Authentication Code generated by UIDAI for each Authentication
Request. This should be printed on receipt in all the cases.
In fund transfer transactions, Recipient must populate DE-103 with To account number and
DE-120 with Beneficiarys name in the response message.
Meaning
. C+
C*
2
O
. O+
1R
A-
Not used.
Mandatory.
Mandatory, echoed from request.
Conditional.
Conditional, value may change.
Optional.
Optional, echoed from request.
Data Element
0800
0810
1
7
Secondary bitmap
Transmission date/time
M
M
M+
M+
11
STAN
M+
15
Date, settlement
C+
32
Acquirer institution ID
39
Response code
Page 12 of 55
48
64
70
128
C*
M+
MACCode2(Optional
MACing)
* DE 48 as per NPCI standards should be Conditional. Since, NPCI does not use dynamic key exchange
so bank should off the bit corresponding to DE 48 in the bitmap.
Data Element
200
210
Secondary bitmap
M+
M+
Processing code
M+
Amount, transaction
C+
Amount, settlement
C+
Date/time, transmission
M+
C+
11
STAN
M+
12
M+
13
M+
14
Date, expiration
15
Date, settlement
C+
18
Merchant type
M+
22
M+
25
M+
26
32
35
Acquirer institution ID
Track2data
M
C
M+
-
37
M+
38
Authorization number
39
Response code
41
M+
42
Card acceptor ID
M+
43
M+
45
Track 1
Page 13 of 55
49
C+
50
C+
52
PIN Block
54
62
Additional amounts
UIDAI Authentication Code
C
M
63
64
MAC code
90
102
103
C
C
C
C
120
Additional Data
121-123
Private use
C*
127
128
MACCode2
Data Element
Secondary bitmap
0420
M
0421*
M
0430
M+
M+
Processing code
M+
Amount, transaction
M+
Amount, settlement
C+
Date/time, transmission
C+
11
STAN
M+
12
M+
13
M+
14
Date, expiration
15
Date, settlement
C+
22
25
26
32
Acquirer institution ID
M+
35
Track2data
37
M+
38
Authorization number
C+
39
Response code
41
Page 14 of 55
Reversal Messages
MTID
42
Data Element
Card acceptor ID
0420
M
0421*
M
0430
-
43
49
M+
50
C+
54
Additional amounts
64
MAC code
90
102
Account 1 identification
103
Account 2 identification
120
Additional Data
C+
121-123
Private use
C*
128
MACCode2
*Reversal 421 messages will be send 3 times after logon message is received from bank if NPCI
fails to get response of 420 message.
Page 15 of 55
10
11
12
13
14
15
16
17
18
19
Purchase of goods/services
Cash withdrawal
Biometric Verification (UID Biometric data verification/Authentication) for ONUS
Credit, refund
Deposit
Credit adjustment
Balance inquiry
Transfer
Extended transaction type**
00
10
20
30
Unspecified/unknown
Savings
Checking
Credit card
00
10
20
30
Unspecified/unknown
Savings
Checking
Credit card
Page 16 of 55
Page 17 of 55
0
1
2
Unspecified.
PIN entry capability.
No PIN entry capability.
Page 18 of 55
6
9
The data element is mandatory for 02xx, and 04xx request messages. It is never present in
response messages.
Field Edits: It should be echoed in response and all subsequent messages.
Constraints: None
DE-25 Point of Service Condition Code
Format: Fixed
Type: n2
Description: Two-digit code indicating conditions at touch point:
00
01
02
03
05
07
08
Normal
Customer not present.
Unattended terminal (CAT, ADM)
Merchant suspicious.
Customer present, card not present.
Telephone request.
MO/TO request.
Page 19 of 55
The data element is mandatory for 02xx, and 04xx request messages. The RRN can be used for the
entire dispute management of the transaction lifecycle.
In verification request value of DE-37 should be same as original remittance transaction RRN
Edit Field: It must be echo back in response message
Constraint: None
DE-39 Response Code
Format: Fixed
Type: an2
Description: This code indicates the disposition of a message as detailed tables below.
Each code is associated with specification code that is to be taken:
A
D
Approve transaction
Decline transaction
Field Edits: In reversal and store/forward requests, value identifies there as on for reversal or
store/forward message.
Constraints:
The following is the addendum covering different scenarios for UID specific situations and
appropriate Response codes supported for declined UID transactions in addition to the existing
response codes referred in the NPCI Host-to-Host specification document. Message to be printed
on Receipt is also specified.
NPCI
error
Code
UIDAI
Error
Code
Description
Message to
be displayed
on MicroATM
Receipt to be
printed by
MicroATM
Yes
Yes
00
Successful
Transaction
91
Decline
Transaction
declined. Please
try again (91)
Yes
Yes
08
Decline
Transaction
declined. Please
try again(08)
Yes
Yes
92
Decline
Invalid IIN(92)
Yes
No
52
Decline
Invalid
Account(52)
Yes
Yes
51
Decline
Insufficient
Funds(51)
Yes
Yes
Page 20 of 55
Residents account.
Transaction declined
by Issuer.
Account blocked by
Issuer/Regulator for
AML or any other
appropriate reasons
Aggregate of all
credits in a financial
year exceed Rs 1 Lakh
Aggregate of all
withdrawals and
transfers in a month
exceeds Rs. 10,000
57
Decline
Account blocked
(57)
Yes
Yes
AY
Decline
Total annual
credits exceed
limit(AY)
Monthly limit
exceeded for
transactions(AM)
Yes
Yes
AM
Yes
Yes
AB
Account Balance
exceeds rupees fifty
thousand
Decline
Account Balance
exceeds limit(AB)
Yes
Yes
M4
Remittance from/to
Foreign/NRE Accounts
Decline
Yes
Yes
Transaction amount
exceeded limit,
transaction is
declined by Issuer.
Decline
Foreign
Remittance not
allowed(M4)
Transaction
amount
exceeded
limit(UW)
UW
Yes
Yes
M6
Decline
Limit exceeded
for member
bank(M6)
No
No
U1
100
Identity attribute of
demographic details
does not match
Decline
No
No
U2
200
Address attribute of
demographic details
does not match
Decline
Identity attribute
of demographic
details does not
match(U1)
Address attribute
of demographic
details does not
match(U2)
No
No
U3
300
Decline
Biometric data
did not
match(U3)
Yes
No
U4
500
Encryption of session
key is invalid
Decline
Transaction
declined. Please
try again(U4)
Yes
No
U5
510
Decline
Transaction
declined. Please
try again(U5)
Yes
No
U6
520
Invalid device
Decline
Wrong Terminal
ID (U6)
Yes
Yes
Decline
Page 21 of 55
U7
530
Invalid authenticator
code
Decline
Invalid
authenticator
code(U7)
Yes
No
U8
540
Invalid version
Decline
Invalid version
(U8)
Yes
No
U9
550
Invalid Uses
element attribute
Decline
Invalid Uses
element
attribute(U9)
No
No
UA
700
Invalid demographic
data
Decline
Invalid
demographic
data(UA)
No
No
UB
710
Missing Pi data as
specified in Uses
Decline
Missing Pi data
as specified in
Uses (UB)
No
No
UC
720
Missing Pa data as
specified in Uses
Decline
Missing Pa data
as specified in
Uses (UC)
No
No
UD
730
Decline
No
No
UE
999
Unknown error
Decline
Transaction
declined. Please
try again(UE)
Yes
No
UF
740
Decline
No
No
UG
800
Decline
Invalid biometric
data(UG)
Yes
No
UH
810
Missing biometric
data as specified in
Uses
Decline
Missing biometric
data as specified
in Uses (UH)
No
No
UI
Decline
Transaction
Declined. Please
try again(UI)
Yes
No
UJ
721
Decline
No
No
Page 22 of 55
UK
820
Missing or empty
value for "bt"
attribute in "Uses"
element
Decline
Missing or empty
value for "bt"
attribute in
"Uses"
element(UK)
No
No
UL
821
Decline
Invalid value in
the "bt" attribute
of "Uses"
element(UL)
No
No
UM
901
Decline
No auth factors
found in auth
request(UM)
No
No
UN
902
Decline
Invalid "dob"
value in "Pi"
element. (UN)
No
No
UO
910
Decline
Invalid "mv"
value in "Pi"
element. (UO)
No
No
UP
911
Decline
Invalid "mv"
value in "Pfa"
element(UP)
No
No
UQ
912
Decline
No
No
Page 23 of 55
is used)
in "Pa"(UQ)
UR
913
Decline
No
No
US
930
Technical error
category 1 (Related
to ABIS interactions)
Decline
Transaction
declined. Please
try again(US)
Yes
No
UT
931
Technical error
category 2 (Internal
to auth server such as
Database server
down, etc.)
Decline
Transaction
declined. Please
try again(UT)
Yes
No
UU
932
Technical error
category 3 (Error if
audit XML could not
be published to audit
queue, or if audit
XML could not be
constructed)
Decline
Transaction
declined. Please
try again(UU)
Yes
No
UV
980
Unsupported option
(At present, this error
is returned if OTP is
used which is yet to
be implemented)
Decline
Unsupported
option(UV)
No
No
UX
933
Decline
Transaction
request older
than 24 hrs. (UX)
Yes
No
UY
511
Decline
No
No
UZ
940
Unauthorized ASA
channel
Decline
Unauthorized
ASA channel(UZ)
No
No
U0
941
Unspecified ASA
channel
Decline
Unspecified ASA
channel(U0)
No
No
V0
561
Request expired
(Pid->ts value is
older than N hours
where N is a
configured threshold
in authentication
server)
Decline
Please correct
your terminal
date & time and
then try again.
(V0)
Yes
No
V1
562
Timestamp value is
future time (value
specified Pid->ts is
ahead of
authentication server
time beyond
acceptable threshold)
Decline
Please correct
your terminal
date & time and
then try again.
(V1)
Yes
No
Page 24 of 55
V2
563
Duplicate request
(this error occurs
when exactly same
authentication
request was re-sent
by AUA)
Decline
Transaction
Declined;
Yes
No
Transaction
declined. Please
try again(V3)
Transaction
declined. Please
try again(V4)
Transaction
declined. Please
try again(V5)
Invalid input(V6)
Yes
No
Yes
No
Yes
No
No
No
Unsupported
language(V7)
No
No
No
No
Please re-enter
all details
again(V2)
V3
564
HMAC Validation
failed
Decline
V4
565
Decline
V5
566
Decline
V6
567
Decline
V7
568
Unsupported
language
Decline
V8
569
Digital signature
verification failed
(this means that
authentication
request XML was
modified after it was
signed)
Decline
Digital signature
verification
failed (V8)
V9
570
Decline
No
No
VA
571
Decline
PIN Requires
reset(VA)
No
No
VB
572
Invalid biometric
position (This error is
returned if biometric
position value - pos
Decline
Invalid biometric
position(VB)
Yes
No
Page 25 of 55
attribute in Bio
element - is not
applicable for a given
biometric type type attribute in
Bio element.)
VC
573
Decline
Pi usage not
allowed as per
license (VC)
Pa usage not
allowed as per
license (VD)
No
No
VD
574
Decline
No
No
VE
575
Decline
No
No
VF
576
Decline
No
No
VG
577
Decline
No
No
VH
578
Decline
No
No
VI
579
Decline
No
No
VJ
580
Decline
No
No
VK
581
Decline
Fuzzy Matching
usage not
allowed as per
license(VK)
No
No
VL
582
Decline
Local language
usage not
allowed as per
license (VL)
No
No
VM
934
Technical error
category 4
Decline
Yes
No
VN
935
Technical error
category 5
Decline
Yes
No
VO
936
Technical error
category 6
Decline
Yes
No
VP
937
Technical error
category 7
Decline
Transaction
declined. Please
try again(VM)
Transaction
declined. Please
try again(VN)
Transaction
declined. Please
try again(VO)
Transaction
declined. Please
try again(VP)
Yes
No
Page 26 of 55
VQ
938
Technical error
category 8
Decline
VR
939
Technical error
category 9
Decline
VS
811
Decline
VT
501
Missing biometric
data in CIDR for given
AADHAAR
Invalid certificate
identifier in ci
attribute of Skey.
VU
502
Invalid encryption of
Pid
Decline
VV
503
Invalid encryption of
Hmac
Decline
VW
542
Decline
VX
543
Sub-AUA not
associated with
AUA
Decline
Decline
Transaction
declined. Please
try again(VQ)
Transaction
declined. Please
try again(VR)
Contact Aadhaar
centre
18001801947 (VS)
Transaction
declined. Please
try again(VT)
Yes
No
Yes
No
Yes
yes
Yes
No
Transaction
declined. Please
try again(VU)
Transaction
declined. Please
try again(VV)
Transaction
declined. Please
try again(VW)
Transaction
declined. Please
try again(VX)
Yes
No
Yes
No
Yes
No
Yes
No
Page 27 of 55
Format: Fixed
Type: an40
Description: The name and location of the acceptor (Touch Point), which defines the point of
service in both local and interchange environments. Special characters (including national
character support characters) are not allowed since some networks or back-office systems may
have problems accepting these characters. Data element consists of the sub-fields detailed in the
table below. The data element is mandatory for 02xx and 04xx request messages.
Field Edits: If present, it should be echoed in response and all subsequent messages.
Character 1-23 Merchant Address / Bank Correspondent Address
Character 24-36 City Name
Character 37-38 State
Character 39-40 Country Code (IN)
DE-45 Track 1 Data
Format: Fixed
Type: ans76
Description: Track 1 data as encoded by Issuer. The standard track structure is as follows:
Card Magnetic Stripe Personalization data
Track 1 Structure Symbol
STX
FC
Card No
FS
NM
FS
ED
SC
DD
Description
Start Sentinel
Format Code
Card number
Separator
Name
Separator
Expiration Date
Service Code
Discretionary Data
ETX
LRC
End Sentinel
Longitudinal Redundancy
Page 28 of 55
Constraints: Data element is present for UID based 02xx response messages.
DE 54Additional Amounts
Format: Fixed
Type: an...120; LLLVAR
Description: It provides information for a maximum of six amounts. It must be populated in 0210
message for all transaction type with account balance.
Field Edits: It must be populated in 0210 message for all transaction type with account balance.
Constraints: None
DE-62 Private Use Field 62 UIDAI Authentication Code
Format: LLLVAR
Type: an999
Description: This Element is used in the response message to send the Authentication Code
received from the UIDAI server; NPCI will send the authentication code to the acquirer in response.
Field Edits: It should be sent back to acquirer bank in response to be displayed in response for all
ONUS transactions, For all offus transactions, NPCI must pass it on to issuer bank to carry the same
in their 210 response.
Constraints: C: Data element is present for UID based 02xx response messages.
DE-63 Private Use Field 63 UID Biometric Authentication Data
Format: LLLVAR
Type: an999
Description: This Element is encrypted containing finger print minutiae collected at the Micro ATM.
Data will contain single minutiae or other UID authentication payload.
Field Edits: None
Constraints: C: Data element is present for UID based 02xx request messages.
Elements Description:
DE63 is structured as TLV (Tag, length and value) field. The details of tags and contents are
described below:
Tag
Length
Description
Valid Value
001
Up to 999 characters
Example:
Lets assume XML tags along with Biometric are 430 bytes. The structure of DE63 is shown
below:
436001430<Encrypted biometric data>
Parsing of field is done as follows:
436 is the length of the string for DE63.
Page 29 of 55
Message Type
0800
0810
logon
echo
cutover
handshake
001
301
201
002
001
301
201
002
Response code for 0810 message must be carried in DE 39 as 00 for successful request.
Constraints: None
DE-90 Original Data Element
Format: Fixed
Type: n42
Description: This data element contains parts of the original message being reversed or adjusted
and is used to match reversal/adjustment to previous authorization or financial transaction
message(s). This data element consists of sub-elements which are described below:
Sub-elements description:
Position
01-04
05-10
11-14
15-20
21-31
32-42
Length
4
6
4
6
11
11
Field Name
Original MTID
Original STAN
Original Local Date
Original Local Time
Original Acquiring Institution ID
Not used (to be filled with zero)
Description
MTID of original request
DE11 of original request
DE12 of original Request
DE13 of original request
DE32 of original request
--
Page 30 of 55
0200 message from acquirer / Issuer to NPCI (for FT acquirer and issuer are same)
Description
Length
Value
Transaction type
2
45(for fund transfer) or 07(for mini statement)
Product indicator
3
UID(for fund transfer) or GDN(for mini statement)
No. of entries in the
002
06 (variable, used only for mini statement)
mini statement data
Actual Mini
210
Each statement will be of 35 character (used only
statement data
for mini statement)
Sender Name
20
Sender Name
Sender AADHAAR no.
19
Sender AADHAAR no. with IIN. Format
BBBBBB0UUUUUUUUUUUU (refer DE2 structure)
0200 message from NPCI to beneficiary bank
Transaction type
2
45(for fund transfer) or 07(for mini statement)
Product indicator
3
UID(for fund transfer) or GDN(for mini statement)
No. of entries in the
002
06 (variable, used only for mini statement)
mini statement data
Actual Mini
210
Each statement will be of 35 character (used only
statement data
for mini statement)
Sender Name
20
Sender Name
Page 31 of 55
060
19
Length
As per
the
process
Type
Variable
Format
an
Description
Skey(Value of this element
is encrypted 256-bit AES
session key.)
Valid Value
Digest value
002
Fixed
YYYYMMDD
003
As per
the
process
Variable
an
004
010
Fixed
an
An
Alpha
numeric
Page 32 of 55
value up
characters
to
10
005
010
Fixed
an
sa (A unique Sub-AUA
code, managed by AUA
within their system and
ensure uniqueness. If AUA
and SA are same agency, use
value of ac for this
attribute.)
An Alpha
value up
characters
numeric
to 10
006
064
Fixed
an
An Alpha
value up
characters
numeric
to 64
Elements Description:
DE 127 is structured as TLV (Tag, length and value) field. The details of tags and contents are
described below:
Example:
Lets assume that skey length is 256 bytes, ci length is 8 bytes, Hmac is 48 bytes, ac is 10
bytes, sa is 10 bytes and lk is 64 bytes. The structure of DE127 is shown below:
432001256<skey>002008<ci>003048<Hmac>004010<ac>005010<sa>006064<lk>
Parsing of field is done as follows:
432 is the total length of the string for DE 127.
1. Tag 001 represents skey which is of length 256 char.
2. Tag 002 represents ci which is of length 8 char.
3. Tag 003 represents Hmac which is of length 48 char
4. Tag 004 represents ac which is of length 10 char
5. Tag 005 represents sa which is of length 10 char
6. Tag 006 represents lk which is of length 64 char
Usage:
The generic description of DE127 is as follows:
<Tag number><Tag length><Tag data><Tag number><Tag length><Tag data>
Page 33 of 55
g. MicroATM application must be able to store all request originating from the device in an
electronic log. These logs will include details of original transaction request, LTS request &
reversal requests and will act as proofs while settling disputes for any transaction.
h. MicroATM application must be capable to push the Electronic Log to acquirer bank switch, at
the end of Business day.
Page 34 of 55
the charge
b. A pro-active Credit Adjustment by the Acquirer. (If an Acquirer sends a proactive credit
adjustment, it should be ensured that a charge back by the issuer is also not allowed. i.e.
Either Acquirer or Issuer will originate an interbank adjustment and not both.)
c. Aadhaar Initiated Cash Deposit Transactions:
National Payments Corporation of India
Page 35 of 55
Case i) the customers account was credited with the cash deposit at the Issuer bank. Due to time
out, the Cash was returned to the customer by the acquirer. Interbank settlement also failed due
to time out status in the NPCI switch.
Issuer bank will simply reverse the credit by passing internal transfer transactions.
Case ii) the customers account was credited with the cash deposit at the Issuer bank. Due to
time out received by the Acquirer, the Cash was returned to the customer. However, interbank
settlement was successful.
The Acquirer will raise a Debit Adjustment with a request to the issuer to reverse the credit
made.
3. This transaction cycle will following timelines:
a. 1st chargeback - Issuer needs to raise this within 60 days from the transaction date.
b. Representment Within 5 days of the receipt of the chargeback for acquirer needs to
represent.
c. Credit Adjustment Acquirer can raise this within 60 days from the transaction date.
d. Debit Adjustment Acquirer can raise this within 17 days from the transaction date.
e. Chargeback on Debit Adjustment- Chargeback on Debit Adjustment will be 17 days from the
next day of Debit Adjustment raised.
f.
Page 36 of 55
g. Fraud Check
h. Duplicate (Multiple) reversals and original transactions.
i.
j.
Page 37 of 55
In case, NPCI doesnt receive the response for a 200 Request message from Issuer, NPCI would send 210
Response to Acquirer with Response Code 91 and generate a Reversal Request (420) message with
Response Code 91 to Issuer Bank, which should reverse the transaction in CBS and respond with Response
Code 00 in 430 Reversal Response message to NPCI.
If NPCI does not get 0430 response from Issuer within 20 seconds it will generate 0421 message thrice
after a logon is received from bank.
In case, Acquirer Bank switch doesnt receive a 210 Response message for the request due to time out, it
should generate a 420 Reversal Request Message with Response Code 68, NPCI will send the message to
Page 38 of 55
Issuer Bank and Issuer needs to reverse the transaction in CBS and respond with 430 message containing
Response Code 00.
If NPCI does not get 0430 response from Issuer within 20 seconds it will generate 0421 message thrice
after a logon is received from bank.
Please refer AEPS reversal cases for complete information on reversals.
Page 39 of 55
Value
Comment
Valid value
MMDDhhmmss
SSSSSS
Valid value as per request type
Secondary Bitmap
Transmission date and time
System Trace Audit Number
Network Management Information Code
0810 message
Data
element
1
7
11
39
70
Value
Comment
Valid value
MMDDhhmmss
SSSSSS
Valid response code 00as per
request type
Original request code as per request
Secondary Bitmap
Date/time, transmission
System Trace Audit Number
Network Management Information Code
Network Management Information Code
41
42
43
45
63
127
Secondary Bitmap
Sender s AADHAAR no.
Processing code for Bio metric
authentication
MMDDhhmmss
Transmission date and time
SSSSSS
System Trace Audit Number
HHMMSS
Time
DDMM
Date
6012
6012 for Micro ATM
01 9 or 02 9
Manual (01), Card Reader present (02)
Reserved for private use (9)
05
Customer present card not present
AcqInst ID
ID already allotted by NPCI
YDDDHHSSSSSS
Y Year (last digit)
DDD Julian Date
HH - Hour
SSSSSS System Trace Audit Number
Card Acceptor Terminal Identification
public
Card Acceptor Identification code
Merchant Name
Card Acceptor Name / Location
Address of BC
Track 1 data
As encoded in Card for card present
transaction
Biometric Data(PID XML)
Bio metric data from finger print scanner
Skey, ci, Hmac and ac, sa, lk
Captured from terminal and fed by AUA
server, respectively
0210 message (From NPCI to Issuer/Acquirer Bank)
Page 40 of 55
Data
element
2
3
Value
Comment
7
11
12
13
32
37
MMDDhhmmss
SSSSSS
HHMMSS
DDMM
ACQ Inst ID
YDDDHHSSSSSS
39
41
42
43
62
00
Card Acceptor Terminal Identification
Card Acceptor Identification code
Card Acceptor Name / Location
UIDAI Auth Code (Max. 40 Characters)
41
42
43
45
49
63
127
Data
Element
2
Secondary Bitmap
Customer details
IIN + AADHAAR
Customer details
Page 41 of 55
3
4
7
11
12
13
15
18
22
25
32
37
41
42
43
45
49
62
Data
element
2
3
4
7
11
12
13
15
32
37
39
41
42
43
49
54
62
Data
element
2
3
4
7
11
(BBBBBB0UUUUUUUUUUUU)
310000
000000000000
MMDDhhmmss
SSSSSS
HHMMSS
MMDD
MMDD
6012
01 9 or 02 9
Customer details
IIN + AADHAAR
(BBBBBB0UUUUUUUUUUUU)
310000
000000000000
MMDDhhmmss
SSSSSS
Customer details
Page 42 of 55
12
13
15
32
37
HHMMSS
MMDD
MMDD
ACQ Inst ID
YDDDHHSSSSSS
39
41
42
43
49
54
62
00
Card Acceptor Terminal Identification
Card Acceptor Identification code
Card Acceptor Name / Location
356
Amount
UIDAI Auth Code (Max. 40 Characters)
Time
Date
Settlement Date (optional)
ID already allotted by NPCI
Y Year (last digit)
DDD Julian Date
HH-Hour
SSSSSS System Trace Audit Number
Success response code
public
Merchant Name
Address of BC
Currency Code
Account Balance
Unique Authentication Code generated by
UIDAI
41
42
43
45
49
63
127
Data
Element
2
3
4
Secondary Bitmap
Customer details
IIN + AADHAAR
(BBBBBB0UUUUUUUUUUUU)
010000
Amount
Customer details
Page 43 of 55
7
11
12
13
15
18
22
25
32
37
41
42
43
45
49
62
Data
Element
2
3
4
7
11
12
13
15
32
37
39
41
42
43
49
54
62
Data
element
2
3
4
7
11
12
13
15
MMDDhhmmss
SSSSSS
HHMMSS
MMDD
MMDD
6012
01 9 or 02 9
Customer details
IIN + AADHAAR
(BBBBBB0UUUUUUUUUUUU)
010000
Amount
MMDDhhmmss
SSSSSS
HHMMSS
MMDD
MMDD
Beneficiary details
Page 44 of 55
32
37
ACQ Inst ID
YDDDHHSSSSSS
39
41
42
43
49
54
62
00
Card Acceptor Terminal Identification
Card Acceptor Identification code
Card Acceptor Name / Location
356
Amount
UIDAI Auth Code (Max. 40 Characters)
41
42
43
45
49
63
127
Data
Element
2
3
4
7
11
12
Secondary Bitmap
Customer details
IIN + AADHAAR
(BBBBBB0UUUUUUUUUUUU)
210000
Amount
MMDDhhmmss
SSSSSS
HHMMSS
Customer details
Page 45 of 55
13
15
18
22
25
32
37
41
42
43
45
49
62
Data
element
2
3
4
7
11
12
13
15
32
37
39
41
42
43
49
54
62
Data
element
2
3
4
7
11
12
13
15
32
37
MMDD
MMDD
6012
01 9 or 02 9
Date
Settlement Date (conditional)
6012 for Micro ATM
Manual (01), Card Reader present (02)
Reserved for private use (9)
05
Customer present card not present
ACQ Inst ID
ID already allotted by NPCI
YDDDHHSSSSSS
Y Year (last digit)
DDD Julian Date
HH- Hour
SSSSSS System Trace Audit Number
Card Acceptor Terminal Identification
Public
Card Acceptor Identification code
Merchant Name
Card Acceptor Name / Location
Address of BC
Track 1 data
As encoded in Card for card present
transaction
356
Currency Code
UIDAI Auth Code (Max. 40 Characters)
Unique Authentication Code generated by
UIDAI
0210 message (from Issuer to NPCI)
Value
Comment
IIN + AADHAAR
(BBBBBB0UUUUUUUUUUUU)
210000
Amount
MMDDhhmmss
SSSSSS
HHMMSS
MMDD
MMDD
ACQ Inst ID
YDDDHHSSSSSS
Beneficiary details
IIN + AADHAAR
(BBBBBB0UUUUUUUUUUUU)
210000
Amount
MMDDhhmmss
SSSSSS
HHMMSS
MMDD
MMDD
ACQ Inst ID
YDDDHHSSSSSS
Beneficiary details
Page 46 of 55
39
41
42
43
49
54
62
00
Card Acceptor Terminal Identification
Card Acceptor Identification code
Card Acceptor Name / Location
356
Amount
UIDAI Auth Code (Max. 40 Characters)
HH-Hour
SSSSSS System Trace Audit Number
Success response code
public
Merchant Name
Address of BC
Currency Code
Account Balance
Unique Authentication Code generated by
UIDAI
Data
element
1
2
3
4
7
11
12
13
15
18
22
25
32
37
Valid value
IIN + AADHAAR
(BBBBBB0UUUUUUUUUUUU)
900000
Amount
MMDDhhmmss
SSSSSS
HHMMSS
MMDD
MMDD
6012
019
05
ACQ Inst ID
YDDDHHSSSSSS
41
42
43
45
49
102
356
Sender Account Detail
120
00100245002003UID045020<Sender
Name>060019IIN+ AADHAAR no.
Data
element
2
3
4
7
11
12
Secondary Bitmap
Beneficiary details
Processing code fixed for FT
Transfer amount
Transmission date and time
System Trace Audit Number
Time
Date
Settlement Date (optional)
6012 for Micro ATM
Manual (01) Reserved for private use (9)
Customer present card not present
Temporary ID already allotted by NPCI
Y Year (last digit)
DDD Julian Date
HH-Hour
SSSSSS System Trace Audit Number
public
Merchant Name
Address of BC
As encoded in Card for card present
transaction
Currency Code
Optional
IIN + AADHAAR
(BBBBBB0UUUUUUUUUUUU)
900000
Amount
MMDDhhmmss
SSSSSS
HHMMSS
Beneficiary details
Processing code fixed for FT
Transfer amount
Transmission date and time
System Trace Audit Number
Time
Page 47 of 55
13
15
18
22
25
32
37
MMDD
MMDD
6012/6010
019
05
ACQ Inst ID
YDDDHHSSSSSS
41
42
43
45
49
356
102
120
Data
element
2
Date
Settlement Date (optional)
6012 for Micro ATM and 6010 for POS
Manual (01) Reserved for private use (9)
Customer present card not present
Temporary ID already allotted by NPCI
Y Year (last digit)
DDD Julian Date
HH- Hour
SSSSSS System Trace Audit Number
public
Merchant Name
Address of BC
As encoded in Card for card present
transaction
Currency Code
Optional
Tag 001 Length 002 45
Tag 002 Length 003 UID
Tag 045 Length 020 - <Sender Name>
(optional)
Tag 060 Length -019 IIN + AADHAAR
(BBBBBB0UUUUUUUUUUUU)
0210 message (from Beneficiary to NPCI)
Value
Comment
Beneficiary details
3
4
IIN + AADHAAR
(BBBBBB0UUUUUUUUUUUU)
900000
Amount
7
11
12
13
15
32
37
MMDDhhmmss
SSSSSS
HHMMSS
MMDD
MMDD
ACQ Inst ID
YDDDHHSSSSSS
39
41
00
Card Acceptor Terminal Identification
54
102
103
120
Amount
Sender Account Detail
Beneficiary Account Detail
00100245002003UID045020<Sender
Name>046020<Beneficiary
Name>060019IIN+ AADHAAR no.
Data
element
2
3
Account Balance
Optional
Optional
Tag 001 Length 002 45
Tag 002 Length 003 UID
Tag 045 Length 020 - <Sender Name>
(optional)
Tag 046 Length 020 - <Beneficiary Name>
(optional)
Tag 060 Length -019 IIN + AADHAAR
(BBBBBB0UUUUUUUUUUUU)
0210 message (from NPCI to Remitter)
Value
Comment
IIN + AADHAAR
(BBBBBB0UUUUUUUUUUUU)
900000
Beneficiary details
Processing code fixed for FT
Page 48 of 55
Amount
Transfer amount
7
11
12
13
15
32
37
MMDDhhmmss
SSSSSS
HHMMSS
MMDD
MMDD
ACQ Inst ID
YDDDHHSSSSSS
39
41
42
43
00
Card Acceptor Terminal Identification
Card Acceptor Identification code
Card Acceptor Name / Location
49
356
Currency Code
54
102
120
Amount
Sender Account detail
00100245002003UID045020<Sender
Name>046020<Beneficiary
Name>060019IIN+ AADHAAR no.
Account Balance
Optional
Tag 001 Length 002 45
Tag 002 Length 003 UID
Tag 045 Length 020 - <Sender Name>
(optional)
Tag 046 Length 020 - <Beneficiary Name>
(optional)
Tag 060 Length -019 IIN + AADHAAR
(BBBBBB0UUUUUUUUUUUU)
Data
element
1
2
3
4
7
11
12
13
15
18
22
Valid value
IIN + AADHAAR no.
Processing Code
Amount
MMDDhhmmss
SSSSSS
HHMMSS
DDMM
MMDD
6012
01 9 or 02 9
25
32
37
05
AcqInst ID
YDDDHHSSSSSS
39
41
42
43
49
00
Card Acceptor Terminal Identification
Card Acceptor Identification code
Card Acceptor Name / Location
Track 1 data
90
Valid values
Secondary Bitmap
Sender s AADHAAR no.
Processing code for original transaction
Original transaction amount
Transmission date and time
System Trace Audit Number
Time
Date
Settlement Date (optional)
6012 for Micro ATM
Manual (01), Card Reader present (02)
Reserved for private use (9)
Customer present card not present
ID already allotted by NPCI
Y Year (last digit)
DDD Julian Date
HH - Hour
SSSSSS System Trace Audit Number
Response code
public
Merchant Name
Address of BC
As encoded in Card for card present
transaction
Original transaction data
Page 49 of 55
102
Data
element
1
2
3
4
7
11
12
13
15
18
22
25
32
37
39
41
42
43
49
90
102
Data
element
1
2
3
4
7
11
12
13
15
18
22
Valid values
FROM Account
0420 message (From NPCI to Issuer)
Value
Comment
Valid value
IIN + AADHAAR no.
Processing Code
Amount
MMDDhhmmss
SSSSSS
HHMMSS
DDMM
MMDD
6012
01 9 or 02 9
Secondary Bitmap
Sender s AADHAAR no.
Processing code for original transaction
Transfer amount
Transmission date and time
System Trace Audit Number
Time
Date
Settlement Date (optional)
6012 for Micro ATM
Manual (01), Card Reader present (02)
Reserved for private use (9)
05
Customer present card not present
AcqInst ID
ID already allotted by NPCI
YDDDHHSSSSSS
Y Year (last digit)
DDD Julian Date
HH - Hour
SSSSSS System Trace Audit Number
00
Response code
Card Acceptor Terminal Identification
public
Card Acceptor Identification code
Merchant Name
Card Acceptor Name / Location
Address of BC
Track 1 data
As encoded in Card for card present
transaction
Valid values
Original transaction data
Valid values
FROM Account
0430 message (From Acquirer to NPCI)
Value
Comment
Valid value
IIN + AADHAAR no.
Processing Code
Amount
MMDDhhmmss
SSSSSS
HHMMSS
DDMM
MMDD
6012
01 9 or 02 9
25
32
37
05
AcqInst ID
YDDDHHSSSSSS
39
41
42
43
49
00
Card Acceptor Terminal Identification
Card Acceptor Identification code
Card Acceptor Name / Location
Track 1 data
90
102
Valid values
Valid values
Secondary Bitmap
Customer s AADHAAR no.
Processing code for original transaction
Transfer amount
Transmission date and time
System Trace Audit Number
Time
Date
Settlement Date (optional)
6012 for Micro ATM
Manual (01), Card Reader present (02)
Reserved for private use (9)
Customer present card not present
ID already allotted by NPCI
Y Year (last digit)
DDD Julian Date
HH - Hour
SSSSSS System Trace Audit Number
Response code
public
Merchant Name
Address of BC
As encoded in Card for card present
transaction
Original transaction data
FROM Account
Page 50 of 55
Data
element
1
2
3
4
7
11
12
13
15
18
22
25
32
37
05
AcqInst ID
YDDDHHSSSSSS
39
41
42
43
49
00
Card Acceptor Terminal Identification
Card Acceptor Identification code
Card Acceptor Name / Location
Track 1 data
90
102
Valid values
Valid values
Comment
Secondary Bitmap
Customers AADHAAR no.
Processing code for original transaction
Transfer amount
Transmission date and time
System Trace Audit Number
Time
Date
Settlement Date (optional)
6012 for Micro ATM
Manual (01), Card Reader present (02)
Reserved for private use (9)
Customer present card not present
ID already allotted by NPCI
Y Year (last digit)
DDD Julian Date
HH - Hour
SSSSSS System Trace Audit Number
Response code
public
Merchant Name
Address of BC
As encoded in Card for card present
transaction
Original transaction data
FROM Account
Page 51 of 55
Page 52 of 55
--------------------------------Format for Electronic logs-------------------------------------5. Format for Original Transaction Electronic log
Bank Name
Original Electronic Log
Date: (dd/mm/yy)
Time: (hh:mm:ss)
BC Name:
Agent Id:
BC Location:
Terminal Id:
Customer Aadhaar No:
Customer Name:
STAN:
RRN:
UIDAI Auth. Code:
Transaction Status: Successful(00)/Decline(response code)
Transaction Amount:
A/C Balance:
Page 53 of 55
Page 54 of 55
Version 2.6.1
Not Available
Not Available
Not Available
Not Available
Message on MicroATM did not had error codes
displayed
Not Available
Page 55 of 55