User creation

This method provides functionality of:

• creating user

• updating data of a previously created user when specifying the same clientId. The sent parameter values overwrite the previous data.

When depositing, a webhook, is sent to the user's personal address, to the depositWebhookUrl specified in the request. When withdrawing (the common method of "Make withdrawal" / make-withdrawal) from a personal address, a status of this withdrawal will be in response.

User creation

POSThttps://ocp.onchainpay.io/api-gateway/personal-addresses/create-user

Header parameters

Body

application/json

clientId*string

User ID in the merchant system

Example: "user12345"

clientEmailstring

User mail

Example: "[e-mail]"

clientNamestring

User name

Example: "John Doe"

depositWebhookUrlstring

URL for notifications of new deposits

Example: "https://merchant.domain/webhooks/user12345"

createAddressesboolean

Create all addresses for the user

groupByBlockchainboolean

Group addresses by blockchain networks (for example, 1 address for bsc, fantom, ethereum networks). This parameter has an effect only when createAddresses: true

checkRisksboolean

Check risks for every incoming transaction to the user's personal addresses. Information about risks will be sent in the webhook to the specified depositWebhookUrl in the risks field

Response

200

Body

application/json

success*boolean

Request success indicator

response*object

Response body of request or user creation

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://ocp.onchainpay.io/api-gateway/personal-addresses/create-user', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "clientId": "user12345",
      "clientEmail": "[e-mail]",
      "clientName": "John Doe",
      "depositWebhookUrl": "https://merchant.domain/webhooks/user12345"
    }),
});
const data = await response.json();

Response

200

{
  "success": true,
  "response": {
    "id": "c886f2dd-669a-4657-ba10-9ad7700cc8e5",
    "clientId": "user12345",
    "clientEmail": "[e-mail]",
    "clientName": "John Doe",
    "depositWebhookUrl": "https://merchant.domain/webhooks/user12345",
    "createdAt": "2024-12-26T08:21:33.226Z",
    "updatedAt": "2024-12-26T08:21:33.226Z",
    "addresses": {
      "id": "2361c9b9-8c89-40b0-ab90-1ade882cf756",
      "userId": "a4aaa006-0fd1-4413-8433-d0fe45c15f89",
      "currency": "USDT",
      "network": "ethereum",
      "address": "0x515b72ed8a97f42c568d6a143232775018f133c8",
      "tag": null,
      "balance": "1234.1234",
      "isActive": true
    }
  }
}