Bank Neo Commerce Open API Docs

1. Overview

Support with the status update request by partner services once has no notification back from BNC.

2. API Specification

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

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
originalReferenceNo	String	O	32	Original transaction identifier on BNC system
originalPartnerreferenceNo	String	O	50	Original transaction identifier on client system
serviceCode	String	M		Transaction type indicator
additionalInfo	Object	O		/
deviceId	String	O		/
channel	String	O		/

3.2.1 Sample Request Body

Pass one or both of originalPartnerreferenceNo and originalReferenceNo
 
{
    "additionalInfo":{
        "channel":"",
        "deviceId":""
    },
    "originalPartnerreferenceNo":"partnerReferenceNo1691728848", //The value of the MPM Code Generation Request Body : partnerReferenceNo
    "serviceCode":"47",
    "originalReferenceNo":"2023081111626423051116587" //The value of the MPM Code Generation Response Body : referenceNo
}

4.1 Response Body

4.1.1 Sample Response Body

Field	Type	Mandatory	Length	Description
responseCode	String	M	7	SNAP Response code.
responseMessage	String	M	256	SNAP response message
originalReferenceNo	String	C	32	Original transaction identifier on BNC system
originalPartnerReference	String	O	50	Original transaction identifier on client’s system
serviceCode	String	M		Transaction type indicator
latestTransactionStatus	String	M	2	00 - success 01 - Initiated 02 - Paying 03 - Pending 04 - refunded 05 - Canceled 06 - Failed 07 - Not found
transactionStatusDesc	String	O	256	Description of transaction status
paidTime	String	C	32	Transaction date with ISO-8601
amount	Object	O		/
value	String	M	10	Net amount of the transaction
currency	String	M	3	/
feeAmount	Object	O
value	String	M	5	Net amount of the transaction
currency	String	M	3	/
terminalId	String	O	32	Terminal ID
additionalInfo	String	O		/
traceId	String	O	64	/
channel	String	O		/
deviceId	String	O		/
RRN	String	M	16	/
bankCode	String	M	32	/
bankName	String	M	50	/

Success:

{
    "feeAmount":{
        "currency":"IDR",
        "value":"0.00"
    },
    "amount":{
        "currency":"IDR",
        "value":"100000.00"
    },
    "originalReferenceNo":"2023081111626423051116587",
    "serviceCode":"47",
    "latestTransactionStatus":"03",  // 03 - Pending
    "additionalInfo":{

    },
    "originalPartnerReferenceNo":"partnerReferenceNo1691728848",
    "responseMessage":"Successful",
    "responseCode":"2005100"
}

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