Bank Neo Commerce Open API Docs

1. Overview

This API allows merchants to unbind their user BNC account from the system.

2. API Specification

HTTP Method	POST
Endpoint	`/open/bi/private/v1.0/registration-account-unbinding`
SNAP Service Code	09

3. Request

3.1. Request Header

	Parameter Name	Type	Length	Required	Description	Sample
1	Authorization	String	163	M	Authorization access token. Bearer type.	Bearer eyJxxxx
2	X-SIGNATURE	String	2048	M	Integrity check. 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)	eTCtU8YjKpwTzvOpao1g/ZQPxKzbsbVs6iTAAECB40aWoCVptjok59uHnbQemvyn3I0FHX/kreMgXMjhs/9NXYuaz3yBzk8TJ9fyYd6DbeeqDDBpTNVaC2dNjCtIjO1xi7ZJ+DLrqz7Wqwn+PwmY+0HJrbM9al5CS/WvjqFXN5FahIRxUfW8Dt3SQ0JNN/ySkz8ari/g7ygiIaLWZf3dSpACgEANiTFfi8YbAJRlMdoRPzwRups8QBdRce8yyW+RhpiEfTeV0CfLdTBiQ7r1HVCZ3V5iU2VxkKj4lXjwbEAJJm6XeEoXugUuLsOYOa8cKQ4bZ2Nxp+xFW6zd3Yk8lA==
3	X-TIMESTAMP	String	25	M	Timestamp request. Formatted as `yyyy-MM-ddTHH:mm:ssS`	2022-09-28T13:00:00+07:00
4	X-CLIENT-KEY	String	32	M	Merchant ID. Provided by Bank.	`000580000134`
5	X-EXTERNAL-ID	String	36	M	Merchant unique request ID. Must be unique per day.
6	CHANNEL-ID	String	5	M	Bank Channel ID.	88881
7	Content-Type	String		M	Request body format type.	application/json

3.2 Request Body

Name	Type	M/O	Length	Description
partnerReferenceNo	String	M	22	Merchant reference number.
merchantId	String	M	32	Merchant ID. Provided by BNC.
subMerchantId	String	O	32	Sub Merchant ID of the Merchant. This property depends on the merchant. Provided by BNC.
tokenId	String	M	32	User account bind token.

3.2.1 Sample Request Body

{
   "partnerReferenceNo":"20201029000000000000011",
   "merchantId":"000580000134",
   "tokenId":"793755ad84cc4ee5a8e8f20e8deeafc7"
}

4. Response

4.1 Response Body

Name	Type	M/O	Length	Description
merchantId	String	M	32	Merchant ID. Provided by BNC.
unlinkResult	String	M	7	Result status: success or failed.
partnerReferenceNo	String	M	22	Merchant reference number.
responseMessage	String	M	64	The message corresponding to the response code.
responseCode	String	M	32	The BI Snap standard of response code.
additionalInfo	Object	M		Additional information
-> traceId	String	M	32	BNC trace ID. Used for tracing in case problem happens

4.1.1 Sample Response Body

Success:

{
    "additionalInfo": {
        "traceId": "400a818a6d1d925c62b0e0f368c1035d"
    },
    "unlinkResult": "success",
    "merchantId": "000580000014",
    "partnerReferenceNo": "20220921888001abcdef",
    "responseMessage": "Successful",
    "responseCode": "2000900"
}

Fail:

{
    "additionalInfo": {
        "traceId": "400a818a6d1d925c62b0e0f368c1035d"
    },
    "unlinkResult": "failed",
    "merchantId": "000580000014",
    "partnerReferenceNo": "20220921888001abcdef",
    "responseMessage": "Customer Token Not Found",
    "responseCode": "4010904"
}

	Error Code	Error Message	Description
1	4040908	Invalid Merchant	Merchant not found.
2	4010904	Customer Token Not Found	Token not found or already unbinding.

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