Account Binding

Information

Merchant use this API to registration Account Binding. The API response provides a webview to registration account binding user. Please using valid phone number to binding the account.

Store the partnerReferenceNo and referenceNo generated during the Account Binding registration process. These reference numbers will be used for Balance Inquiry and Unbinding.

Field	Value
Path	/{version}/registration-account-binding
HTTP Method	POST
Service Code	07
Version	v1.0
Type Format	JSON

Request Body

Details

Parameter	Data Type	Mandatory	Length	Description
partnerReferenceNo	String	M	64	Transaction identifier on service consumer system
merchantId	String	C	64	Merchant identifier that is unique per each merchant. Note: This field is optional for the CIMB channel.
additionalData	Object	O	-
additionalData.email	String	O	254	User email registered on merchant’s platform. For example [email protected]
msisdn	String	M	15	Phone number to be binded
redirectUrl	String	M	2048	When user authorization is complete, the user will be redirected to this URL
additionalInfo	Object	O	-	Additional information for custom use that are not provided by SNAP

Example Request

Details

POST …/v1.0/registration-account-binding HTTP/1.2
Content-type: application/json
Authorization: Bearer gp9HjjEj813Y9JGoqwOeOPWbnt4CUpvIJbU1mMU4a11MNDZ7Sg5u9a"
X-TIMESTAMP: 2020-12-18T13:43:31+07:00
X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5
X-PARTNER-ID: 82150823919040624621823174737537
X-EXTERNAL-ID: 41807553358950093184162180797837
CHANNEL-ID: 95221

{
   "partnerReferenceNo":"2020102900000000000001",
   "additionalData":{
      "email":"[email protected]",
   },
   "msisdn":"62812345678901",
   "redirectUrl":"merchantapp://main_page",
   "additionalInfo":{
   }
}

Response Body

Details

Parameter	Data Type	Mandatory	Length	Description
responseCode	String	M	7	Response code
responseMessage	String	M	150	Response description
referenceNo	String	C	64	Transaction identifier on service provider system. Must be filled upon successful transaction
partnerReferenceNo	String	O	64	Transaction identifier on service consumer system
nextAction	String	O	255	Redirect the user to this URL for authentication
redirectUrl	String	O	2048	Redirect URL
additionalInfo	Object	O	-	Additional information for custom use that are not provided by SNAP

Example Response

Details

Content-type: application/json
X-TIMESTAMP: 2020-12-18T13:43:37+07:00
X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5

{
   "responseCode":"2000700",
   "responseMessage":"Request has been processed successfully",
   "referenceNo":"2020102977770000000009",
   "partnerReferenceNo":"2020102900000000000001",
   "nextAction":"https://gopayapi.com/validate/otp/abcd123456789",
   "redirectUrl":" https://www.merchantapi.com/redirect/abcd123456789",
   "additionalInfo":{
   }
}