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

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

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

• обновить данные ранее созданного пользователя при указании того же 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: [email protected]

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": "[email protected]",
  "clientName": "John Doe",
  "depositWebhookUrl": "https://merchant.domain/webhooks/user12345",
  "createAddresses": true,
  "groupByBlockchain": true,
  "checkRisks": true
}

200Success

{
  "success": true,
  "response": {
    "id": "7a5da491-23d6-40be-93db-550069ef7235",
    "clientId": "user12345",
    "clientEmail": "[email protected]",
    "clientName": "John Doe",
    "depositWebhookUrl": "https://merchant.domain/webhooks/user12345",
    "createdAt": "2025-06-09T11:38:26.579Z",
    "updatedAt": "2025-06-09T11:38:26.579Z",
    "addresses": {
      "id": "0e8e5b6f-1d2c-4ca6-9505-f913bcd1ec5d",
      "userId": "f44582c6-6ece-416b-95e1-de850244588b",
      "currency": "USDT",
      "network": "ethereum",
      "address": "0x515b72ed8a97f42c568d6a143232775018f133c8",
      "tag": null,
      "balance": "1234.1234",
      "isActive": true
    }
  }
}