Bank Neo Commerce Open API Docs

1. Overview

Support with the status update from BNC and send to partner services.

2. API Specification

Endpoint	Interface address will be provided by partners
Service Code	52

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	M	3	Transaction identifier on BNC system
originalPartnerReferenceNo	String	O	32	Transaction identifier on client system, only available for dynamic payment.
latestTransactionStatus	String	M	50	00 - success 01 - Initiated 02 - Paying 03 - Pending 04 - refunded 05 - Canceled 06 - Failed 07 - Not found
transactionStatusDesc	String	O	2	Description status transaction
customerNumber	String	O	256	CPAN from issuer
accountType	String	O	19	Account type
destinationNumber	String	O		/
destinationAccountName	String	O		/
amount	Object	O
value	String	M		Net amount of the transaction
currency	String	M	10	/
sessionID	String	O	3	/
bankCode	String	O		/
additionalInfo	Object	O		/
RRN	String	M	16	/
scID	String	O	64	available for static trx
bankName	String	M	32	/
trxType	String	M	50	Indicate the transaction type, include PAYMENT and REFUND.
devideId	String	O		/
channel	String	O		/

3.2.1 Sample Request Body

{
    "additionalInfo":{
        "bankCode":"93600490",
        "bankName":"Bank Neo Commerce",
        "errorCode":"",
        "feeMoney":{
            "currency":"IDR",
            "value":"0.00"
        },
        "rRN":"419731711619",
        "trxType":"PAYMENT"
    },
    "amount":{
        "currency":"IDR",
        "value":"20000.00"
    },
    "customerNumber":"5859459100025153",
    "latestTransactionStatus":"00",
    "originalPartnerReferenceNo":"202311085564003931736522752",
    "originalReferenceNo":"2023110816742149053013962"
}

4.1 Response Body

Field	Type	Mandatory	Length	Description
responseCode	String	M		SNAP Response code.
responseMessage	String	M		SNAP response message
additionalInfo	Object	O		/

4.1.1 Sample Response Body

Success:

 {"responseCode":"2005200","responseMessage":"Success"}

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