Bank Neo Commerce Open API Docs

1. Overview

The call back would be raised by BNC once the registration had already done.

2. API Specification

Endpoint	/
BNC Service Code	Q2

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	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	1	Indicate the current audit status. 1.AUDITING 2.SUCCESS 3.FAILED
resultCode	String	M	515	Indicate the failure process.
auditDetail	array	O		Audit reject details only support for the auditStatus meet 2XX_success.
field	String	O	256	The field will indicate which merchant detail needs to update if the registration meet failed.
rejectCode	List	O	256
rejectReason	String	O	512	Reject message.

3.2.1 Sample Request Body

{
    "applicationCode":"202305011691667272",
    "applymentCode":"111689601116502073344",
    "auditDetail":[
        {
            "rejectCode":[ "0" ],
            "rejectReason":"script mock fail by ：202305102100"
        }
    ],
    "auditStatus":"3",
    "mId":"000580000456",
    "resultCode":"300"
}

4.1 Response Body

Field	Type	Mandatory	Length	Description
applicationCode	String	M	64	/
mId	String	M	12	/

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