Account Inquiry
This API is used to verify the validity of the recipient’s account at the destination bank before executing an interbank fund transfer via a payment infrastructure provider (e.g., RTOL or BI-FAST).
Technical Specification
Service Code: 42Required 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
customerNumber
String
M
1
32
Customer phone number in 08xx format
3
amount
Object
M
1
2
Transaction amount
4
amount.value
String
M
1
16,2
Filled with transaction amount value. 2 decimal digits format
5
amount.currency
String
M
3
3
Filled with IDR
6
beneficiaryAccountNumber
String
M
1
32
Destination account number
7
additionalInfo
Object
M
1
2
Additional transfer details
8
additionalInfo.beneficiaryBankCode
String
M
1
5
Destination bank code. Bank code list is shared separately
9
additionalInfo.transferType
String
M
1
10
Type Of Transfer Method:
BI-FAST,
RTOL
Sample Request
Body Response
1
responseCode
String
M
1
7
Response code
2
responseMessage
String
M
1
150
Response description
3
referenceNo
String
C
1
64
Transaction identifier on service provider system. Must be filled upon successful transaction
4
partnerReferenceNo
String
O
1
64
Transaction identifier on service consumer system
5
beneficiaryAccountNumber
String
M
1
32
Destination account number
6
beneficiaryAccountName
String
M
1
64
Destination account name
7
beneficiaryBankCode
String
M
1
5
Destination bank code
8
beneficiaryBankName
String
M
1
25
Destination bank name
9
amount
Object
O
1
2
10
amount.value
String
M
1
16,2
Net amount of the transaction. If it's IDR then value includes 2 decimal digits. e.g. IDR 10.000,- will be placed with 10000.00
11
amount.currency
String
M
3
3
Currency (ISO 4217)
12
additionalInfo
Object
O
1
1
Additional information
13
additionalInfo.redirectUrl
String
C
1
512
Redirect URL to go to PJSP page to process the payment. Mandatory if H2H mode
Sample Response
Response Code & Message
1
200
2004200
Successful
2
400
4004200
Bad request
3
400
4004201
Invalid field format {field}
4
400
4004202
Invalid mandatory field {field}
5
401
4014200
Unauthorised. [Reason]
6
401
4014201
Invalid token (B2B)
7
401
4015202
Invalid Customer Token
8
401
4015203
Token Not Found (B2B)
9
401
4015204
Customer Token Not Found
10
403
4034201
Feature not allowed
11
404
4043219
Invalid Bill/Virtual Account
12
500
5004200
General error
13
504
5044200
Timeout
Last updated