# Account Creation & Binding

<figure><img src="https://627965603-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FImVr2HJay0snj5ukhBJK%2Fuploads%2FTkFfu08gwOouR51hHCRB%2Funknown.png?alt=media&#x26;token=7ed8c792-d74c-4136-9bd6-6bb2ebbbad24" alt=""><figcaption></figcaption></figure>

## **Method and URL**

`POST` \[BASE\_URL]/wallet-backend/snap/v1.0/registration-account-creation

Purpose: Create and bind an account.<br>

Authorization:

* B2B Token&#x20;

## **Request**

**Request Header**

<table><thead><tr><th width="252.0615234375">Header</th><th width="121.7216796875">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
{
  "partnerReferenceNo": "USER081800008888",
  "merchantId": "88042168-bfa6-4e5c-bcca-5abf1d40a181",
  "name": "Brasco Zig",
  "phoneNo": "081800008888",
  "redirectUrl": "https://www.test.com/"
}
```

**Request Parameter Detail**&#x20;

<table><thead><tr><th>Parameter</th><th width="115.970703125">Data Type</th><th width="120.7626953125">Character Limir</th><th width="115.8447265625">Requirement</th><th>Description</th></tr></thead><tbody><tr><td>partnerReferenceNo</td><td>String</td><td>64</td><td>Mandatory</td><td>Unique reference number from partner/merchant for this account creation request.</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>phoneNo</td><td>String</td><td>15</td><td>Mandatory</td><td>User’s phone number in MSISDN format (e.g., 6281234567890).</td></tr><tr><td>name</td><td>String</td><td>50</td><td>Mandatory</td><td>User’s full name.</td></tr><tr><td>redirectUrl</td><td>String (URL)</td><td>255</td><td>Mandatory</td><td>URL to redirect the user after creation/onboarding is completed.</td></tr></tbody></table>

\ <br>

## **Response**

**Response Body**

```json
{
  "additionalInfo": {
    "activationLink": "https://wallet-stg.harsya.com/whitelabel/account-linkage-bind?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJ3YWxsZXQtYmFja2VuZCIsInN1YiI6IjAxOTY1NjcwLWZmYzYtN2U3MC05YjY5LTRkODU0MDkwNzdjOSIsImV4cCI6MTc1NDI5NTg2NywiaWRlbnRpZmllclZhbHVlIjoiMDE5NjU2NzAtZmZjNi03ZTcwLTliNjktNGQ4NTQwOTA3N2M5IiwibWVyY2hhbnRJZCI6Ijg4MDQyMTY4LWJmYTYtNGU1Yy1iY2NhLTVhYmYxZDQwYTE4MSIsInNlc3Npb25JZCI6Ijg4MDQyMTY4LWJmYTYtNGU1Yy1iY2NhLTVhYmYxZDQwYTE4MSJ9.QXWxTNm3JwHXRdHENn7vxzkxLCUp3a13uuRke_uRuGQ",
    "expiredAt": "2025-08-04T15:24:27.415024635+07:00"
  },
  "referenceNo": "01987420-dc76-7ea6-a8d0-34956542b2b4",
  "responseCode": "2000600",
  "responseMessage": "Successful"
}
```

**Response Parameter Detail**

<table><thead><tr><th>Parameter</th><th width="108.82421875">Data Type</th><th width="112.740234375">Character Limit</th><th width="128.2470703125">Requirement</th><th>Description</th></tr></thead><tbody><tr><td>additionalInfo</td><td>Object</td><td>-</td><td>Mandatory</td><td>Contains the activation link and expiration details.</td></tr><tr><td>additionalInfo.activationLink</td><td>String (URL)</td><td>255</td><td>Mandatory</td><td>Activation URL that redirects the user to complete their onboarding process.</td></tr><tr><td>additionalInfo.expiredAt</td><td>String (ISO 8601)</td><td>25</td><td>Mandatory</td><td>Expiration date and time of the activation link.</td></tr><tr><td>referenceNo</td><td>String</td><td>100</td><td>Mandatory</td><td>Description of the API result (e.g., "OK" or error message).</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>