These docs are for v3.0. Click to read the latest docs for v4.0.

Kuna Codes Overview

Kuna имеет особый функционал для трансфера средств между аккаунтами, без комиссий и СМС. Он называется Kuna Code. Блок KUNA CODES доступен только для пользователей с ролью “Merchant“. Чтобы получить доступ к данному блоку, пожалуйста, обратитесь к нам в бот поддержки в Telegram: @KunaSupport_bot.

Всего, тело Kuna Code состоит из 45 символов (или 9 сегментов по 5 символов) и суфикса.

📘

Kuna Code имеет структуру:

857ny-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-KUN-KCode

Первый сегмент из 5-ти символов - это публичная часть кода.
Потом идет 8 сегментов по 5 символов, это приватная часть кода.
Суфикс KUN-KCode это валюта и метка что это код от Куны.

Статусы кодов

Название статусаОписание
createdБыл создан
processingВ процессе выпуска
unconfirmedОжидает подтверждения
activeМожно активировать
redeemingВ процессе активации
redeemedАктивирован
onholdПод подозрением
canceledОтменен

API объект Kuna Code

Почти все методы возвращают одинаковую структуру данных для Kuna Code. Будь то создание, или получение конкретного кода, или получение списка кодов, вы всегда получите такие данные:

{
  # внутренний ID
  "id": 519,

  # ID для указания к супорту
  "sn": "p9MajCjlLo72",

  # секретный ключ кода, по которому он и активируется
  "code": "857ny-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-KUN-KCode",

  # Kuna-ID того кто может активировать код.
  # если 'all' то активировать может кто угодно
  "recipient": "all",

  # сумма кода
  "amount": "800000",

  # валюта кода
  "currency": "kun",

  # статус кода
  "status": "active",

  # время, до которого нельзя активировать код владельцем
  "non_refundable_before": "2019-08-20T13:00:00+02:00",

  # время создания кода
  "created_at": "2019-03-20T13:00:00+02:00",

  # время активации кода
  "redeemed_at": null,

  # публичный коментарий кода
  "comment": "Try to activate inside your Plark Wallet",

  # приватный коментарий кода
  "private_comment": "Ripple to the MOON!"
}

Ошибки

В случае ошибки API веренет сообщение вида

{ messages: ['code_not_found'] }