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.

Path	/v1.0/registration-account-binding
HTTP Method	POST
Service Code	07
Type Format	JSON

Request Body

Details

Parameter	Data Type	Mandatory	Length	Description
partnerReferenceNo	String	M	64	Transaction identifier on service consumer system
merchantId	String	M	64	Merchant identifier that is unique per each merchant.
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":{
   }
}