Internal Account Inquiry
This API is used to validate the recipient's internal e-money account before initiating a peer-to-peer transfer. It ensures that the destination account is active and eligible to receive funds.
Technical Specification
Service Code: 15Required Headers
Use the standard Linkage authentication headers, signature, and device context on every request.
1
Content-Type
String
M
Fill with application/json
2
Authorization
String
M
Access token B2B
3
Authorization-Customer
String
M
Access token B2B2C
4
X-TIMESTAMP
String
M
Timestamp in RFC3339 format: yyyy-MM-ddTHH:mm:ssTZD
5
X-PARTNER-ID
String
M
Client ID provided by Finnet
7
X-EXTERNAL-ID
String
M
Random string that must be unique within a day for each partner with max 36 characters
8
CHANNEL-ID
String
M
Device identification on which the API services is currently being accessed by the End User (Customer)
9
ORIGIN
String
M
The domain of the calling application
10
X-IP-ADDRESS
String
M
The IP address of the device
11
X-DEVICE-ID
String
M
The unique identifier of the device
12
X-LATITUDE
String
M
The latitude coordinate from the device’s GPS
13
X-LONGITUDE
String
M
The longitude coordinate from the device’s GPS
Body Request
1
partnerReferenceNo
String
M
1
64
Transaction identifier on service consumer system
2
beneficiaryAccountNo
String
M
1
34
Beneficiary account number
Sample Request
Body Response
1
responseCode
String
M
1
7
Response code
2
responseMessage
String
M
1
150
Response description
3
referenceNo
String
O
1
64
Transaction identifier on service provider system
4
partnerReferenceNo
String
O
1
64
Transaction identifier on service consumer system
5
beneficiaryAccountNo
String
M
1
34
Destination account number
6
beneficiaryAccountName
String
M
1
100
Destination account name
7
currency
String
M
3
3
Currency (ISO 4217)
8
additionalInfo
Object
O
1
1
9
additionalInfo.redirectUrl
String
M
1
512
Redirect URL to go to PJSP page to process the payment.
Sample Response
Response Code & Message
1
200
2001500
Successful
2
400
4001500
Bad request
3
400
4001501
Invalid field format {field}
4
400
4001502
Invalid mandatory field {field}
5
401
4011501
Invalid token (B2B)
6
401
4011500
Unauthorised. [Reason]
7
401
4011502
Invalid Customer Token
8
401
4011503
Token Not Found (B2B)
9
401
4011504
Customer Token Not Found
10
403
4031501
Feature not allowed
11
403
4031504
Activity count limit exceeded
12
403
4031514
Insufficient Funds
13
404
4041508
Invalid merchant
14
500
5001500
General error
15
500
5001501
Internal Server Error
16
500
5001502
External Server Error
17
504
5041500
Timeout
Last updated