Криптовалюта

Перед тем как начать

Обзор

Оплата криптовалютой — это обычный заказ. Дополнительные поля не нужны: способ оплаты определяется терминалом, к которому подключён ваш сервис. Заказ можно создать в фиате или сразу в криптовалюте:

Плательщик не выбирает токен и сеть: они заданы в настройках терминала. Какие токены и сети подключены для вашего аккаунта, уточните у менеджера.

Точность сумм

Запрос с большим числом знаков отклоняется с 400. Суммы в ответах API и webhook-уведомлениях округлены до этой же точности.

Пример запроса

Заказ в фиате — обычный запрос на создание заказа в RUB или USD:

curl -X POST "https://api.panel.valutix.kz/v1/orders" \
  -H "Content-Type: application/json" \
  -H "X-Api-Token: YOUR_API_TOKEN" \
  -d '{
    "amount": "5000.00",
    "currency": "RUB",
    "serviceId": 3,
    "externalId": "order_12345",
    "purpose": "Оплата заказа #12345",
    "successUrl": "https://example.com/success",
    "failUrl": "https://example.com/fail",
    "callbackUrl": "https://example.com/webhooks/payments"
  }'

Заказ в криптовалюте — в той валюте, которой платит плательщик, сумма в ней же:

curl -X POST "https://api.panel.valutix.kz/v1/orders" \
  -H "Content-Type: application/json" \
  -H "X-Api-Token: YOUR_API_TOKEN" \
  -d '{
    "amount": 0.00125,
    "currency": "BTC",
    "serviceId": 4,
    "externalId": "order_12346",
    "successUrl": "https://example.com/success",
    "callbackUrl": "https://example.com/webhooks/payments"
  }'

Ответ

В ответе возвращается стандартный объект заказа. Заказ создаётся со статусом CREATED; перенаправьте плательщика на paymentLink, чтобы он завершил оплату.

Заказы с оплатой криптовалютой получают paymentType: "CRYPTO", когда выдана ссылка на оплату.

Что видит плательщик

Перенаправьте плательщика на paymentLink. В зависимости от терминала он попадает на одну из двух страниц:

• страницу оплаты провайдера, где и завершает оплату;
• нашу платёжную форму с реквизитами перевода:
  • адрес кошелька и его QR-код;
  • точная сумма в токене;
  • тег / memo, если он нужен сети. Перевод без него не зачисляется, поэтому плательщик должен указать его в точности как на форме;
  • таймер: сколько ещё действуют реквизиты.

Итоговая сумма

Сумма заказа с оплатой криптовалютой может отличаться от запрошенной. Если плательщик перевёл меньше нужного, заказ остаётся в PENDING до истечения срока оплаты: в это время плательщик ещё может доплатить. После этого заказ закрывается как COMPLETED на фактически оплаченную сумму в валюте заказа: у заказа в фиате — эквивалент в фиате, у заказа в криптовалюте — переведённая сумма токена. Поле amount заказа обновляется до этого значения.

Перевод другим токеном автоматически не зачисляется: такой заказ разбирается вручную.

Статусы

У заказов с оплатой криптовалютой обычные статусы заказа:

Webhook-уведомления отправляются при каждой смене статуса, как и для других способов оплаты, см. Статус заказа и webhook-уведомления.

Тестовый режим

На тестовом терминале перевод не выполняется; статус заказа зависит от суммы, как и для других способов оплаты: 1000 — COMPLETED, 1001 — CANCELED, 1002 — FAILED, 1003 — COMPLETED, затем REFUND, любая другая сумма — EXPIRED через 5 минут.

Рекомендации

Следующие шаги