Быстрый старт

Создание API-ключа

В дашборде откройте страницу API и создайте ключ. Сырой ключ (формат ak_...) показывается один раз, при создании — скопируйте его сразу и сохраните как секрет. Вы можете отзывать и создавать ключи здесь в любое время.

Настройка webhook (рекомендуется)

На той же странице API укажите свой Webhook URL (публично доступный по HTTPS) и скопируйте секрет для подписи (whsec_..., тоже показывается один раз). Именно сюда отправляются окончательные результаты заказов. Вы можете пропустить этот шаг и использовать опрос, но webhook — это путь с меньшей задержкой.

Обмен ключа на токен доступа

Обменяйте свой ключ ak_ на короткоживущий Bearer-токен (действителен 2 часа):

$
curl -X POST https://api.voodoo.center/api/v1/auth/token/client \
>
  -H "Content-Type: application/json" \
>
  -d '{"api_key":"ak_your_api_key_here"}'

1
{
2
  "access_token": "eyJhbGciOiJFZERTQSIsImtpZCI6Ii4uLiJ9...",
3
  "token_type": "Bearer"
4
}

Отправляйте access_token как Authorization: Bearer <access_token> в каждом другом запросе. Обменивайте ключ повторно, когда срок действия токена истекает.

Проверка баланса (необязательная проверка)

$
curl https://api.voodoo.center/api/v1/account/balance \
>
  -H "Authorization: Bearer <access_token>"

1
{ "balance": 1240.75 }

Размещение первого заказа

Купите товар типа key. POST /api/v1/orders списывает средства с вашего баланса и сразу возвращает 201 со status: "pending" — выполнение происходит в фоне.

$
curl -X POST https://api.voodoo.center/api/v1/orders \
>
  -H "Authorization: Bearer <access_token>" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "item_id": 4090,
>
    "quantity": 2,
>
    "merchant_order_id": "po-10231"
>
  }'

1
{
2
  "id": "0190f8a1-6b2c-7e33-9a10-4c1d2e3f5a6b",
3
  "status": "pending",
4
  "merchant_order_id": "po-10231",
5
  "source": "api"
6
}

Всегда отправляйте уникальный merchant_order_id — это делает повторные попытки идемпотентными.

Получение результата на webhook

Когда заказ завершается, Voodoo Center отправляет POST с подписанным событием на ваш webhook-URL. Проверьте X-Webhook-Signature относительно сырого тела запроса, а затем прочитайте терминальный status, доставленные codes и любой refund_amount:

1
{
2
  "order_id": "0190f8a1-6b2c-7e33-9a10-4c1d2e3f5a6b",
3
  "merchant_order_id": "po-10231",
4
  "status": "completed",
5
  "delivered_quantity": 2,
6
  "refund_amount": 0,
7
  "codes": ["ABCD-1234-EFGH-5678", "IJKL-9012-MNOP-3456"]
8
}

Пока не хотите запускать webhook? Вместо этого опрашивайте GET /api/v1/orders/{id}, пока status не станет терминальным.