К содержанию
Lumean API

POST/reseller/codes/{uuid}/cancel

Отмена неактивированного кода реселлера в окне после выпуска (reseller_cancel_window_minutes из настроек); стоимость возвращается на баланс реселлера. Вне окна — 409 gift_code_cancel_window_expired, уже активирован или отменён — 409 gift_code_not_cancellable. Право: reseller.write.

reseller.write
На этой странице(3)

Параметры

Поля ввода живут прямо в строке запроса: подставьте значение — и получите готовый URL. Ниже — тип, обязательность и допустимые значения каждого параметра.

POSThttps://api.lumean.app/api/public/reseller/codes//cancel
  • stringв путиобязательный

    UUID подарочного кода — 36 символов, не сам код вида LUM-….

    Берётся из поля uuid: его возвращают POST /reseller/codes при выпуске и GET /reseller/codes в списке. Чужой или несуществующий код → 404 с reason: gift_code_not_found.

    Значение подставляется прямо в строку запроса выше.

Возможные ответы

200

GiftCodeResource

Пример тела
{
  "data": {
    "uuid": "string",
    "code_masked": "string",
    "code": "string",
    "nominal": "string",
    "nominal_formatted": 1,
    "cost": "string",
    "cost_formatted": 1,
    "discount_bps": 1,
    "source": "string",
    "funding": "string",
    "status": "string",
    "activatable_at": "string",
    "redeemed_at": "string",
    "cancelled_at": "string",
    "created_at": "string",
    "currency_asset": {
      "code": "string",
      "precision": 1
    }
  }
}
Поля ответа
dataобязательное

Полезная нагрузка ответа.

GiftCodeGiftCode
uuidобязательное

UUID кода. Его подставляют в пути GET /reseller/codes/{uuid} и POST /reseller/codes/{uuid}/cancel.

string
code_maskedобязательное

Код с маской, LUM-****-****-XXXX: его безопасно показывать в интерфейсе и писать в логи.

string
codeнеобязательное

ПОЛНОЕ значение кода — то, что вводит получатель при активации. Публичный API реселлера отдаёт его в списке, при показе и при выпуске. Обращайтесь как с секретом: кто знает код, тот его и активирует.

string
nominalобязательное

Номинал кода в минимальных единицах LMC: real = nominal / 10^currency_asset.precision. Столько LMC получит активатор.

string
nominal_formattedобязательное

Тот же номинал в целых LMC — число, готовое к показу.

number
costнеобязательное

Сколько код стоил реселлеру с учётом скидки, в минимальных единицах LMC. Приходит только у кодов реселлера (source: reseller).

string
cost_formattedнеобязательное

Та же стоимость в целых LMC. Приходит только у кодов реселлера.

number
discount_bpsнеобязательное

Скидка реселлера на момент выпуска, в базисных пунктах (100 = 1%). Позднейшая смена личной скидки этот код не меняет. Приходит только у кодов реселлера.

integer
sourceобязательное
string
fundingобязательное
string
statusобязательное
string
activatable_atобязательное

С какого момента код можно активировать: до него код заморожен. null — ограничения нет.

string
redeemed_atобязательное

Когда код активирован. null, пока не активирован. Кто его активировал, API не раскрывает.

string
cancelled_atобязательное

Когда реселлер отменил код. null, если код не отменялся.

string
created_atобязательное

Когда код выпущен.

string
currency_assetобязательное

Валюта сумм ответа — LMC. По precision суммы в минимальных единицах переводятся в целые LMC.

object
codeобязательное

Код актива, в котором выражены суммы.

ЗначенияLUMC
string
precisionобязательное

Сколько знаков после запятой у LMC: real = value / 10^precision.

integer

Рядом

Объекты

Соседние операции

Скормить страницу ИИ

Открыть .mdllm.md

спека 0.0.1