Статический адрес

Постоянный депозитный адрес, выданный одному клиенту под один актив, без фиксированной суммы и срока, где каждый входящий перевод зачисляется отдельно.

#Как это работает в CryptoLike

CryptoLike создаёт статический адрес запросом POST /v1/addresses с coin_id, вашим customer_id и необязательной меткой label. Каждый перевод на него зачисляется на ваш баланс после подтверждений актива. Вебхук deposit.pending приходит, когда перевод замечен в сети, deposit.confirmed — когда он зачислен, с комиссией платформы в deposit.fee и зачисленной суммой в deposit.net_amount.

Активный адрес один на пару «актив + клиент»: повторный запрос для той же пары вернёт 409 conflict. Чтобы выдать новый адрес, архивируйте старый в кабинете — архивный адрес продолжает принимать переводы. GET /v1/addresses/{id} возвращает историю депозитов с total_received, tx_count и last_deposit_at. Перевод, откатившийся из-за реорганизации цепочки, приходит событием deposit.reverted, а перевод, задержанный на проверку, — событием deposit.on_hold.

#Статический адрес или платёж?

В CryptoLike есть два способа принять средства: разовый платёж (инвойс) под заказ и статический адрес для балансов, пополнений и регулярного фондирования. Оба создаются одним вызовом API и сообщают о себе подписанными вебхуками; различаются они суммой, сроком и событиями:

#Пример

Статический адрес CryptoLike создаётся один раз на клиента и актив: сохраните полученный address в профиле пользователя и показывайте его при каждом пополнении. coin_id берётся из GET /v1/currencies; тело запроса отправляется на POST /v1/addresses с ключом, у которого есть право create_address:

{
  "coin_id": "6f1c2a3e-8d4b-4c5a-9e7f-0a1b2c3d4e5f",
  "customer_id": "user-8812",
  "label": "Top-up wallet"
}

На статических адресах строятся пополнения баланса в криптовалюте: один адрес на пользователя, зачисление каждого перевода.