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

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

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

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

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

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

post

/api-gateway/personal-addresses/create-user

Header parameters

x-api-public-keystring

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

x-api-signaturestring

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

Content-typestring

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

Example: application/json

Body

clientIdstringrequired

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

Example: user12345

clientEmailstring

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

Example: [e-mail]

clientNamestring

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

Example: John Doe

depositWebhookUrlstring

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

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

createAddressesboolean

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

groupByBlockchainboolean

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

checkRisksboolean

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

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://ocp.onchainpay.io/api-gateway/personal-addresses/create-user' \
  --header 'Content-Type: application/json' \
  --data '{"clientId":"user12345","clientEmail":"[e-mail]","clientName":"John Doe","depositWebhookUrl":"https://merchant.domain/webhooks/user12345"}'

200

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
    }
  }
}