Словарь криптоплатежей
Каждый термин объяснён сначала одним предложением, а затем — через статусы, поля и события, которые использует CryptoLike. Слова везде одни и те же: статус на странице оплаты — та же строка, что в API и в ваших вебхуках, а комиссия всегда названа точно — комиссия платформы или комиссия сети.
Словарь поможет читать документацию API, отвечать клиенту на вопрос о платеже и договориться о формулировках внутри команды. Каждый термин ведёт в раздел документации, где он используется, и к связанной статье.
Б
- Белый список адресов выплат
- Заранее одобренные адреса для выплат: как CryptoLike откладывает активацию новых адресов, применяет список к кабинету и API-ключам и что возвращает отказ.
В
- Вебхук
- HTTP-запрос, который платформа отправляет на ваш сервер при изменении платежа: как CryptoLike доставляет вебхуки, повторяет их и почему нужен event_id.
- Второе подтверждение выплаты
- Крупную выплату перед отправкой подтверждает второй человек: как CryptoLike задаёт порог для актива, кто может подтвердить и что значит awaiting_approval.
Г
- Горячий кошелёк
- Что такое горячий кошелёк, зачем он платёжной платформе для выплат и как CryptoLike ограничивает сумму в нём и переводит излишки в холодное хранение.
И
- Идентификатор транзакции (txid)
- Что такое идентификатор транзакции, где CryptoLike показывает его для платежей, пополнений и выплат и как по нему проверить перевод в обозревателе блоков.
- Истёкший платёж
- Срок оплаты вышел, а подтверждённого перевода нет. Что CryptoLike делает с таким платежом, что видит клиент и как поступить со средствами, пришедшими позже.
К
- Ключ идемпотентности
- Уникальное значение запроса, с которым повтор возвращает первый результат, а не дубль. Как API CryptoLike использует Idempotency-Key, order_id и payout_id.
- Комиссия платформы
- Плата криптопроцессинга сверх комиссии сети: как CryptoLike задаёт её для каждого актива и направления и кто её платит — вы или плательщик.
- Комиссия сети
- Плата блокчейну за запись транзакции: кто платит её при входящем криптоплатеже и как CryptoLike резервирует и списывает комиссию сети при выплатах.
- Криптовалютный инвойс
- Разовый счёт на фиксированную сумму со сроком оплаты и своей страницей оплаты: как в CryptoLike создать инвойс, указать цену, принять оплату и узнать статус.
Н
- Недоплата
- Клиент перевёл меньше, чем нужно: как CryptoLike держит адрес открытым для доплаты, что показывает remaining_amount и что делать после истечения срока.
П
- Переплата
- Клиент перевёл больше, чем нужно: CryptoLike оставляет статус paid, зачисляет всю сумму на баланс и показывает излишек в поле overpaid_amount.
- Подпись вебхука
- Хеш с ключом, который доказывает, что вебхук пришёл от платформы и не изменён. Как проверить заголовок X-Signature от CryptoLike по сырому телу запроса.
- Подтверждения
- Что такое подтверждения в блокчейне, как CryptoLike задаёт порог для каждого актива и когда криптоплатёж переходит из pending в paid и зачисляется.
Р
- Реорганизация блоков (reorg)
- Что такое реорганизация блоков, почему обнаруженный перевод — ещё не платёж и как CryptoLike сторнирует зачисление и уведомляет вас, если reorg отменил перевод.
С
- Ссылка на оплату
- Ссылка, которая открывает страницу оплаты одного криптоплатежа: как CryptoLike создаёт её через API, в кабинете или в Telegram-боте и сколько она действует.
- Статический адрес
- Постоянный адрес для одного клиента и одного актива: как CryptoLike зачисляет каждый перевод на него и чем такой адрес отличается от разового платежа.
- Стейблкоин
- Криптотокен, привязанный эмитентом к фиатной валюте: какие стейблкоины принимает CryptoLike, в каких сетях и как выставить платёж в USDT или USDC.
Т
- Тестовая сеть и тестовые ключи
- Что такое тестовая сеть, как тестовые ключи CryptoLike (ck_test_) работают с тестовыми сетями и как оплатить тестовый платёж тестовыми монетами до запуска.
Ф
- Фиксация курса
- Курс фиата к крипте фиксируется, пока клиент платит: когда CryptoLike фиксирует курс, сколько он держится и что показывают поля rate_locked и rate_locked_at.
Х
- Холодный кошелёк
- Что такое холодный кошелёк, чем он отличается от горячего и как CryptoLike переводит излишки в холодное хранение только после подтверждения оператора с 2FA.
Э
- Энергия и bandwidth в TRON
- Что такое энергия и bandwidth в сети TRON, почему для перевода USDT TRC20 нужен TRX и кто платит за ресурсы при оплате покупателем и при выплате CryptoLike.
E
- ERC20
- Стандарт токенов Ethereum: как CryptoLike принимает USDT и USDC в ERC20, зачем плательщику ETH на газ и как страница оплаты показывает сеть перевода.
K
- KYB (проверка бизнеса)
- Что такое KYB-проверка, каким функциям CryptoLike нужен проверенный аккаунт, какие документы загружаются и что происходит, пока проверка идёт.
T
- TRC20
- Стандарт токенов сети TRON: как CryptoLike принимает USDT в TRC20, что нужно плательщику в кошельке и почему важно предупреждение о сети на странице оплаты.
Начните с тестового платежа
Создайте аккаунт, попросите у поддержки доступ к тестовой среде и посмотрите, как платёж проходит путь от pending до paid в тестовой сети.