Account Unbinding

Method and URL

POST [BASE_URL]/wallet-backend/snap/v1.0/registration-account-unbinding

Purpose: Unbind or disconnect an already-bound Pivot Pay wallet account from the merchant’s application.

Authorization:

• B2B Token

Request

Request Header

Header	Requirement	Description
Content-Type	Mandatory	application/json
Authorization	Mandatory	Bearer {B2B_access_token}
X-SIGNATURE	Mandatory	HMAC signature generated as per SNAP specification HMAC_SHA512 (clientSecret, stringToSign) stringToSign = HTTPMethod +”:“+ EndpointUrl +":"+ AccessToken +":“+ Lowercase(HexEncode(SHA-256(minify(RequestBody))))+ ":“ + TimeStamp
X-TIMESTAMP	Mandatory	Request timestamp in yyyy-MM-dd'T'HH:mm:ssXXX (ISO 8601 with offset)
X-PARTNER-ID	Mandatory	Partner ID assigned by Pivot
X-EXTERNAL-ID	Mandatory	Unique ID per request for idempotency / tracing
CHANNEL-ID	Mandatory	Channel identifier (e.g., 12345)

Request Body

{
  "additionalInfo": {
    "failedRedirectUrl": "https://test.com",
    "redirectUrl": "https://test.com"
  },
  "merchantId": "88042168-bfa6-4e5c-bcca-5abf1d40a181",
  "tokenId": "78042168-bfa6-4e5c-bcca-5abf1d40a182"
}

Request Parameter Detail

Parameter	Data Type	Character Limit	Requirement	Description
additionalInfo	Object	-	Optional	Container for additional information.
additionalInfo.failedRedirectionUrl	String (URL)	255	Optional	URL to redirect the user if unbinding fails.
additionalInfo.redirectionUrl	String (URL)	255	Optional	URL to redirect the user if unbinding is completed.
merchantId	String	36	Mandatory	Merchant ID assigned by Pivot Pay.
tokenId	String	36	Mandatory	User Binding ID, Same ID used in generate B2B2C token

Response

Response Body

{
  "additionalInfo": {
    "expiredIn": "2025-08-04T16:54:03+07:00",
    "redirectUrl": "https://wallet-stg.harsya.com/whitelabel/account-linkage-unbind?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJ3YWxsZXQtYmFja2VuZCIsInN1YiI6IjE0NzFlNGFjLTI3N2ItNGJiNi04MmQ4LWFlZTY4ODNhNTg2ZCIsImV4cCI6MTc1NDMwMTI0MywiaWRlbnRpZmllclZhbHVlIjoiMTQ3MWU0YWMtMjc3Yi00YmI2LTgyZDgtYWVlNjg4M2E1ODZkIiwibWVyY2hhbnRJZCI6Ijg4MDQyMTY4LWJmYTYtNGU1Yy1iY2NhLTVhYmYxZDQwYTE4MSIsInNlc3Npb25JZCI6Ijg4MDQyMTY4LWJmYTYtNGU1Yy1iY2NhLTVhYmYxZDQwYTE4MSJ9.CHlfFBK8DopiJNnlzI_-SAagTXmqjLVq2DP2wpE1x-k"
  },
  "responseCode": "2000900",
  "responseMessage": "Successful"
}

Response Parameter Detail

Parameter	Data Type	Character Limit	Requirement	Description
additionalInfo	Object	-	Optional	Response status code. "00" indicates success, other codes indicate failure or specific error states.
additionalInfo.expiredIn	String (ISO 8601)	25	Mandatory	Expiration date and time of the unbinding link.
additionalInfo.redirectUrl	String (URL)	255	Optional	URL to redirect the user to complete unbinding process.
responseCode	String	7	Mandatory	Response status code.
responseMessage	String	100	Mandatory	Description of the result.