Bank Neo Commerce Open API Docs

1. Overview

This API method allows you to retrieve your certain daily transaction or settlement reports within 90 days.

If the request date exceeds the date limit, an error code 「Invalid date」will be returned.

If the daily report is not yet generated for the certain date, an error code 「Not yet generated」will be returned.

2. API Specification

Endpoint	SNAP Test Env URL: https://perf-openbanking.bankneo.co.id/open/bi/private/v1.0/qr/query/report SNAP Prod Env URL: https://openbanking.bankneo.co.id/open/bi/private/v1.0/qr/query/report
Service Code	79

3. Request

3.1. Request Header

Name	Type	M/O	Description	Sample
Content-Type	application/json	M	Content type	application/json
Authorization	String	M	/	Bearer gp9HjjEj813Y9JGoqwOeOPWbnt4CUpvIJbU1mMU4a11MNDZ7Sg5u9a"
X-TIMESTAMP	String	M	yyyy-MM-dd HH:mm:ss	2020-12-17T10:55:00+07:00
X-SIGNATURE	String	M	/	85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c8625 61b19a5
ORIGIN	String	M	/	www.hostname.com
X-PARTNER-ID	String	M	/	82150823919040624621823174737537
X-EXTERNAL-ID	String (36)	M	/	41807553358950093184162180797837
CHANNEL-ID	String	M	/	95221

3.1.1 Sample Request Header

Content-type: application/json
Authorization: Bearer gp9HjjEj813Y9JGoqwOeOPWbnt4CUpvIJbU1mMU4a11MNDZ7Sg5u9a"
X-TIMESTAMP: 2020-12-17T10:55:00+07:00
X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5
ORIGIN: www.hostname.com
X-PARTNER-ID: 82150823919040624621823174737537
X-EXTERNAL-ID: 41807553358950093184162180797837
CHANNEL-ID: 95221

3.2 Request Body

Field

Type

Mandatory

Length

Description

reportType

String

01=transaction report

02=settlement report

reportDate

String

YYYY-MM-DD

3.2.1 Sample Request Body

{
    "reportType": "02", // 01 Transaction report, 02 Settlement report
    "reportDate": "2023-10-18"
}

4.1 Response Body

Field	Type	Mandatory	Length	Description
responseCode	String	M	7	SNAP Response code.
responseMessage	String	M	256	SNAP response message
reportDownloadUrl	String	O	512
additionalInfo	Object	O
errorCode	String	O	20

4.1.1 Sample Response Body

Success:

{
	"reportDownloadUrl": "https://test-img2.bankneo.co.id/qris/bill/file_000540000684_20231016.xlsx?Expires=1698043771&OSSAccessKeyId=LTAI5tLCwoWdtFG6cPqtj7aL&Signature=pZW8SvDGVRbbliU1L5qx4tJxXH4%3D&response-content-disposition=inline&response-content-type=application%2Foctet-stream",
	"additionalInfo": {
		"traceId": "4737b1bf1c2f0e11576f8dec35558842"
	},
	"responseMessage": "Successful",
	"responseCode": "2007900"
}

5. Reference

	Field Code	Field Name	Description
1	M	Mandatory	Mandatory
2	ME	Mandatory Equal	Mandatory Equal – value in the request and the response must be the same.
3	C	Conditional	Conditional
4	CE	Conditional Equal	Conditional Equal – value in the request and the response must be the same.
5	O	Optional	Optional