Bank Neo Commerce Open API Docs

1. Overview

Support the registration result inquiry when the merchant can not get the result back from BNC.

2. API Specification

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

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

applicationCode

String

Unique request number generated by merchants system.

Optional parameter for the registration result inquiry.

applymentCode

String

The applymentCode was generated by the BNC system and matched with this registration request.

Optional parameter for the registration result inquiry.

3.2.1 Sample Request Body

ApplicationCode and applicationCode two parameters pass one or both pass


{
    "applicationCode":"202305011691669029", 
    "applymentCode":"111689608487605342208"
}

4.1 Response Body

Field	Type	Mandatory	Length	Description
responseCode	String	M	7	SNAP Response code.
responseMessage	String	M	256	SNAP response message
applicationCode	String	M	64	The application code which had been generated by the merchant system.
applymentCode	String	M	64	The applymentCode was generated by the BNC system and matched with this registration request.
mId	String	M	12	Support for the sub-merchant or store ID to inquiry the registered status.
auditStatus	String	M	2	Indicate the current audit status. 1.AUDITING 2.SUCCESS 3.FAILED
resultCode	String	O	515	Indicate the failure process.
auditDetail	array			Audit reject details only support for the auditStatus meet 2_success.
field	String	M	256	The field will indicate which merchant detail needs to update if the registration meet failed.
rejectCode	String	M	256
rejectReason	String	O	512	Reject message.

4.1.1 Sample Response Body

Success:

{
    "additionalInfo":{},
    "mId":"000550000457",
    "auditStatus":"2",
    "responseMessage":"Successful",
    "responseCode":"200Q300"
}

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