Криптоплатежи для цифровых товаров, SaaS и онлайн-сервисов

CryptoLike позволяет цифровому бизнесу выдавать товар автоматически, как только криптоплатёж подтверждён. Ваш сервер создаёт платёж одним вызовом API, клиент платит на странице оплаты, а подписанный вебхук сообщает серверу, что пора открыть доступ. Так работают лицензионные ключи, пополнения, периоды подписки и кредиты сервиса — без ручной проверки блокчейна.

#Почему цифровому продукту нужен API, а не кнопка оплаты?

Цифровой продукт выдаёт код, а не человек, поэтому платёж должен быть понятен машине. Коду нужно знать, что платёж подтверждён, сколько пришло и к какому заказу он относится, и выдать товар ровно один раз, даже если сообщение повторилось. CryptoLike даёт всё это полями API и правилами вебхуков.

Без этого доступ открывается по переводу, который только обнаружен, повтор запроса выдаёт товар дважды, реорганизация сети отменяет перевод, уже принятый за оплату, а суммы во float теряют точность.

#Как CryptoLike встраивается в автоматическую выдачу

Интеграция с CryptoLike — это три части на вашем сервере: создать платёж, отправить на него клиента и обработать один вебхук. Секрет API не покидает сервер. Всё, что нужно коду выдачи, приходит вместе с платежом, включая ваш номер заказа и до 20 пар метаданных.

1. Создайте платёж через POST /v1/invoices: сумма, валюта (фиатный код, например USD, или тикер монеты), ваш order_id и при необходимости metadata. С заголовком Idempotency-Key повтор в течение 24 ч вернёт тот же платёж.
2. Отправьте клиента на checkout_url или встройте страницу виджетом оплаты, чтобы он остался в вашем приложении; браузер получает только id платежа.
3. Выдавайте по invoice.paid. Проверьте подпись, пропустите уже обработанный event_id, откройте доступ и ответьте 2xx.

{
  "amount": "29.00",
  "currency": "USD",
  "order_id": "sub-8812-2026-10",
  "metadata": { "plan": "pro", "period": "2026-10" },
  "return_url": "https://app.example.com/billing/done"
}

metadata возвращается в API и в каждом вебхуке invoice.*, никогда не показывается плательщику и ограничена 20 строковыми парами и 4 КБ.

#На что может опираться ваша интеграция

CryptoLike публикует контракт платежа, поэтому ваш код может заранее обработать каждый случай, от повтора вебхука до лимита запросов. Числа в таблице взяты из документации API и вебхуков. Они описывают поведение платформы по отношению к вашему серверу, а не обещание о скорости подтверждений в сети.

Статусы платежа: new, pending, paid, underpaid, expired и cancelled; только paid означает, что деньги подтверждены и зачислены. Если реорганизация отменила подтверждённый перевод, придёт invoice.reverted: приостановите выдачу до нового invoice.paid. Подробнее — в модели статусов платежа.

#Как подключить

Для интеграции с CryptoLike нужен сервер, который хранит секрет API, тестовый ключ и https-эндпоинт для вебхуков. Официальные SDK для TypeScript, Python, Go и PHP подписывают запросы, повторяют их, добавляют ключи идемпотентности и проверяют вебхуки. Это пре-релиз: до публикации в реестрах пакетов SDK устанавливаются из репозитория.

1. Попросите у поддержки CryptoLike доступ к тестовой среде: в её кабинете создайте ключ ck_test_ с правами create_invoice и read и используйте адрес её API.
2. Установите SDK: TypeScript SDK, Python SDK, Go SDK или PHP SDK — или подписывайте запросы сами по описанию аутентификации API.
3. Создайте платёж и оплатите его в тестовой сети.
4. Обработайте вебхук по руководству как проверять вебхуки криптоплатежей.
5. Переключитесь на боевой ключ.

Все маршруты — в справочнике API, комиссия платформы по активам — на странице тарифов.

Продаёте тарифы с продлением? Смотрите раздел криптоплатежи для подписок: один инвойс на расчётный период с ценой в USD.

#Вопросы и ответы

#Когда открывать доступ: на pending или на paid?

На paid. pending значит, что перевод обнаружен и ждёт подтверждений, и он ещё может не покрыть сумму. paid значит, что вся сумма подтверждена и зачислена на ваш баланс.

#Как не выдать товар дважды?

Проверьте подпись и найдите event_id в своём хранилище: если он уже был, ответьте 2xx и остановитесь. Доставка «как минимум один раз», повторы — норма. При создании платежей передавайте Idempotency-Key, чтобы повтор запроса не создал второй платёж.

#Можно ли продавать подписки?

Да, одним платежом на период. Каждый криптоперевод отправляет сам клиент, поэтому автоматически с его кошелька ничего не списывается. Создавайте платёж на каждый период, показывайте или отправляйте ссылку, а тариф и период кладите в metadata.

#Что, если клиент отправил больше цены?

Платёж получает статус paid, вся сумма зачисляется на ваш баланс, а вебхук содержит overpaid_amount больше нуля. Товар выдаётся как обычно, а разницу вы урегулируете с клиентом.