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: 15

Environment	Method	URL
Development	POST	https://snapstag.finnet.co.id/v1.0/account-inquiry-internal
Production	POST	https://snap.finnet.co.id/v1.0/account-inquiry-internal

Required Headers

Use the standard Linkage authentication headers, signature, and device context on every request.

No	Name	Type	Mandatory	Description
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
6	X-SIGNATURE	String	M	BI SNAP symmetric signature. See Signature for details.
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

No	Name	Type	Mandatory	Min Length	Max Length	Description
1	partnerReferenceNo	String	M	1	64	Transaction identifier on service consumer system
2	beneficiaryAccountNo	String	M	1	34	Beneficiary account number

Sample Request

POST .../v1.0/account-inquiry-internal HTTP/1.2
Content-type: application/json
Authorization: Bearer gp9HjjEj813Y9JGoqwOeOPWbnt4CUpvIJbU1mMU4a11MNDZ7Sg5u9a"
Authorization-Customer: Bearer fa8sjjEj813Y9JGoqwOeOPWbnt4CUpvIJbU1mMU4a11MNDZ7Sg5u9a"
X-TIMESTAMP: 2020-12-23T08:27:11+07:00
X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5
ORIGIN: www.hostname.com
X-PARTNER-ID: 82150823919040624621823174737537
X-EXTERNAL-ID: 41807553358950093184162180797837
X-IP-ADDRESS: 172.24.281.24
X-DEVICE-ID: 09864ADCASA
X-LATITUDE: -6.108841
X-LONGITUDE: 106.7782137
CHANNEL-ID: 95221
{
  "partnerReferenceNo":"2020102900000000000001",
   "beneficiaryAccountNo":"6281221700001"
}

Body Response

No	Name	Type	Mandatory	Min Length	Max Length	Description
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

{
  "responseCode": "2001500",
  "responseMessage": "Request has been processed successfully",
  "referenceNo": "2020102977770000000009",
  "partnerReferenceNo": "2020102900000000000001",
  "beneficiaryAccountName": "Yories Yolanda",
  "beneficiaryAccountNo": "6281221700001",
  "currency": "IDR",
  "additionalInfo": {
    "redirectUrl": " https://fm.f1n.me/prem?uuid=f47ac10b-58cc-4372-a567-0e02b2c3d479&sessionToken=abcde12345"
  }
}

Response Code & Message

No	HTTP Code	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