Создание пользователя

Метод позволяет:

• создать пользователя персональных адресов.

• обновить данные ранее созданного пользователя при указании того же clientId. Присланные значения параметров перезаписывают предыдущие данные.

При депозите на персональный адрес пользователя присылается вебхук, на указанный в запросе depositWebhookUrl. При выводе (общий метод "Создание вывода" /make-withdrawal) с персонального адреса ответ со статусом приходит сразу.

Создание пользователя

post

Header parameters

x-api-public-keystringOptional

Публичный API-ключ

x-api-signaturestringOptional

Подпись тела запроса приватным API-ключем

Content-typestringOptional

Тип тела запроса

Example: application/json

Body

Тело запроса создания пользователя

clientIdstringRequired

Идентификатор пользвателя в системе мерчанта

Example: user12345

clientEmailstringOptional

Почта пользователя

Example: [e-mail]

clientNamestringOptional

Имя пользователя

Example: John Doe

depositWebhookUrlstringOptional

URL для уведомлений о новых пополнений

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

createAddressesbooleanOptional

Создать все адреса для пользователя

groupByBlockchainbooleanOptional

Сгруппировать адреса по блокчейн сетям (например, 1 адрес для сетей bsc, fantom, ethereum). Данный параметр имеет эффект только при createAddresses: true

checkRisksbooleanOptional

Проверять риски каждой входящей транзакции на персональные адреса пользователя. Информация о рисках будет приходить в вебхуке на указанный depositWebhookUrl в поле risks

Responses

200Success

application/json

post

HTTPcURLJavaScriptPython

POST /api-gateway/personal-addresses/create-user HTTP/1.1
Host: ocp.onchainpay.io
Content-Type: application/json
Accept: */*
Content-Length: 211

{
  "clientId": "user12345",
  "clientEmail": "[e-mail]",
  "clientName": "John Doe",
  "depositWebhookUrl": "https://merchant.domain/webhooks/user12345",
  "createAddresses": true,
  "groupByBlockchain": true,
  "checkRisks": true
}

200Success

{
  "success": true,
  "response": {
    "id": "43449ae0-e6e1-4a69-aea0-cd08054c7ccf",
    "clientId": "user12345",
    "clientEmail": "[e-mail]",
    "clientName": "John Doe",
    "depositWebhookUrl": "https://merchant.domain/webhooks/user12345",
    "createdAt": "2025-05-14T13:39:50.475Z",
    "updatedAt": "2025-05-14T13:39:50.475Z",
    "addresses": {
      "id": "aab7d331-9a4f-42ce-8c31-4d3a57e220e9",
      "userId": "5bddfd19-2443-410f-a2a9-76ed0b1ef364",
      "currency": "USDT",
      "network": "ethereum",
      "address": "0x515b72ed8a97f42c568d6a143232775018f133c8",
      "tag": null,
      "balance": "1234.1234",
      "isActive": true
    }
  }
}