Создание интента и проведения платежа [new] - оплата фиатом

Оплата фиатом

1. Общая информация

API позволяет создать intent для оплаты через Transak и получить сведения о ранее созданном PaymentIntent по идентификатору.

Базовый URL: https://external.api.nbcgate.tech

Авторизация: для всех запросов передавайте интеграционный ключ:

• X-API-Key: <ваш_ключ>

Заголовки:

• Content-Type: application/json

• Accept: application/json (рекомендуется)

Префикс маршрутов: все методы ниже — с префиксом /api/intent/transak/....

---

2. Этапы работы

Шаг 1. Создание intent (Transak)

Метод и URL: POST /api/intent/transak/create

Пример запроса (cURL):

curl -X POST 'https://external.api.nbcgate.tech/api/intent/transak/create' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: <ваш_ключ>' \
  -d '{
    "id": 12345,
    "amount": 10000
  }'

Тело запроса (IntentCreateReq):

Поле	Тип	Обязательное	Описание
id	number	да	Идентификатор pay link
amount	number	да	Сумма (целое число; единицы задаются логикой CryptoPay)

Успешный ответ (200): объект TransakParams.

Пример (фрагмент):

{
  "apiKey": "...",
  "cryptoCurrencyCode": "...",
  "defaultPaymentMethod": "...",
  "disableWalletAddressForm": false,
  "fiatAmount": 100.5,
  "fiatCurrency": "USD",
  "network": "...",
  "partnerOrderId": "...",
  "walletAddress": "...",
  "addr": "...",
  "url": "...",
  "isAutoFillUserData": false
}

Основные поля ответа (TransakParams):

Поле	Тип	Описание
apiKey	string	Параметр для Transak
cryptoCurrencyCode	string	Код криптовалюты
defaultPaymentMethod	string	Способ оплаты по умолчанию
disableWalletAddressForm	boolean	Отключение формы адреса кошелька
fiatAmount	number	Сумма в фиате
fiatCurrency	string	Код фиатной валюты
network	string	Сеть
partnerOrderId	string	Идентификатор заказа партнёра
walletAddress	string	Адрес кошелька
addr	string	Доп. адрес/параметр при необходимости
url	string	URL виджета/редиректа Transak
isAutoFillUserData	boolean	Автозаполнение данных пользователя

---

Шаг 2. Получение сведений о PaymentIntent (Transak)

Метод и URL: POST /api/intent/transak/retrieve

Пример запроса (cURL):

curl -X POST 'https://external.api.nbcgate.tech/api/intent/transak/retrieve' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: <ваш_ключ>' \
  -d '{
    "id": "pi_xxx_or_transak_order_id"
  }'

Тело запроса (IntentRetrieveReq):

Поле	Тип	Обязательное	Описание
id	string	да	Идентификатор intent/заказа (формат задаёт CryptoPay/Transak)

Успешный ответ (200): объект TransakInfoParams: блоки meta и data (подробный состав ответа Transak).

Упрощённый пример:

{
  "meta": {
    "orderId": "..."
  },
  "data": {
    "_id": "...",
    "status": "...",
    "fiatCurrency": "USD",
    "cryptoCurrency": "...",
    "fiatAmount": 0,
    "cryptoAmount": 0,
    "walletAddress": "...",
    "network": "...",
    "transactionHash": "...",
    "transactionLink": "..."
  }
}

---

3. Полный сценарий

1. POST /api/intent/transak/create → TransakParams (в т.ч. url и параметры Transak).

2. POST /api/intent/transak/retrieve с id → статус и детали заказа в TransakInfoParams.

---

4. Ошибки

HTTP	Когда
400	Некорректный JSON или невалидные поля
401	Нет или неверный X-API-Key
500	Ошибка при обращении к CryptoPay или разборе ответа

Формат тела ошибки: statusCode, message, при необходимости массив errors с полем code.