Bank Neo Commerce Open API Docs

1. Overview

The Callback service allows merchants to receive binding result from BNC web binding operation. The Callback only happens when the binding operation is success.

2. API Specification

HTTP Method	POST
Endpoint	<PARTNER API ENDPOINT>
SNAP Service Code	N/A

3. Request

3.1. Request Header

Name	Type	M/O	Length	Description
X-TIMESTAMP	String	M	25	The request timestamp. Formatted with "yyyy-MM-ddTHH:mm:ssZ". E.g. 2022-09-06T13:00:00+07:00
X-CLIENT-KEY	String	M	32	The Merchant or Client Id. Provided by Merchant.
X-SIGNATURE	String	M	2048	The Merchant or Client generated signature. Using Asymmetric-Signature mechanism to get the token, encrypted with SHA256withRSA. e.g. stringToSign = <HTTP Method> + ":" + <Service Endpoint> + ":" + toLowercase(hexEncode(SHA256(minify(<Request Body>)))) + ":" + <X-TIMESTAMP> X-SIGNATURE = SHA256withRSA(PrivateKey, stringToSign)
X-EXTERNAL-ID	String	M	36	The Merchant External ID of request. e.g. 77778042022091500001
CHANNEL-ID	String	M	5

3.1.1 Sample Request Header

N/A

3.2 Request Body

Name	Type	M/O	Length	Description
partnerReferenceNo	String	M	22	Merchant transaction reference number. Should be unique.
accountNo	String	M	16	User account number. Bank provided in masking value.
accountTransactionLimit	String	M	8,2	User maximum amount without using OTP validation for transaction.
additionalInfo	Object	M		Additional Information
-> userId	String	M	64	Merchant generated User Id.
-> token	String	M	36	User generated bank card token.
-> bindStatus	String	M	2	User binding status. Always in `1`

3.2.1 Sample Request Body

{
  "accountCurrency": "IDR",
  "accountNo": "585945******2348",
  "accountTransactionLimit": 500000.00,
  "additionalInfo": {
    "userId": "8881701",
    "token": "c9fead3d790f41d4819456ebc13f2910"
    "bindStatus": "1"
  },
  "partnerReferenceNo": "BEL2210170001"
}

4. 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