# Account Unbinding

## **Method and URL**

<mark style="color:green;">`POST`</mark> \[<mark style="color:orange;">BASE\_URL</mark>]/wallet-backend/snap/v1.0/registration-account-unbinding

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

Authorization:

* B2B Token&#x20;

## **Request**

**Request Header**

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

**Request Body**

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

**Request Parameter Detail**&#x20;

<table><thead><tr><th>Parameter</th><th width="109.8056640625">Data Type</th><th width="105.7724609375">Character Limit</th><th width="131.0283203125">Requirement</th><th>Description</th></tr></thead><tbody><tr><td>additionalInfo</td><td>Object</td><td>-</td><td>Optional</td><td>Container for additional information.</td></tr><tr><td>additionalInfo.failedRedirectionUrl</td><td>String (URL)</td><td>255</td><td>Optional</td><td>URL to redirect the user if unbinding fails.</td></tr><tr><td>additionalInfo.redirectionUrl</td><td>String (URL)</td><td>255</td><td>Optional</td><td>URL to redirect the user if unbinding is completed.</td></tr><tr><td>merchantId</td><td>String</td><td>36</td><td>Mandatory</td><td>Merchant ID assigned by Pivot Pay.</td></tr><tr><td>tokenId</td><td>String</td><td>36</td><td>Mandatory</td><td>User Binding ID, Same ID used in generate B2B2C token</td></tr></tbody></table>

## **Response**

**Response Body**

```json
{
  "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**

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

\ <br>