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

В этом руководстве мы покажем, как провести ваш первый платёж через API Datagio Finance с использованием протокола cURL.

Шаг 1. Получение API-ключей

Для выполнения запросов сервер-сервер вам понадобятся:

• X-API-Key: Идентификатор вашего мерчанта.
• X-API-Secret: Секретный ключ для подписи запросов.

Получить их можно в личном кабинете в разделе Мерчанты -> Настройки API.

[!WARNING] Никогда не передавайте X-API-Secret на стороне клиента (в мобильных приложениях или фронтенд-коде). Этот ключ должен храниться исключительно на вашем бэкенд-сервере.

Шаг 2. Создание платёжной ссылки

Платёжная ссылка позволяет перенаправить клиента на защищённую страницу оплаты Datagio, где он сможет выбрать удобный метод (СБП, карта или криптовалюта).

Отправьте следующий POST-запрос:

curl -X POST https://api.datagio.finance/merchant/v1/payment-links \
  -H "X-API-Key: pk_live_your_key" \
  -H "X-API-Secret: sk_live_your_secret" \
  -H "Content-Type: application/json" \
  -d '{
    "shop_id": "b79ffcef-5f6e-4adf-aa5f-e885b4d282d9",
    "amount": 1500,
    "description": "Оплата подписки"
  }'

Пример ответа API

В случае успеха вы получите JSON-ответ со статусом 201 Created:

{
  "id": "9c0526fe-0e45-423d-91ca-368e98b8ea96",
  "shop_id": "b79ffcef-5f6e-4adf-aa5f-e885b4d282d9",
  "amount": "1500.00",
  "currency": "RUB",
  "status": "pending",
  "checkout_url": "https://datagio.finance/checkout/9c0526fe-0e45-423d-91ca-368e98b8ea96",
  "created_at": "2026-07-20T12:00:00Z"
}

Шаг 3. Перенаправление пользователя

Перенаправьте плательщика по адресу checkout_url. После завершения оплаты на ваш сервер будет отправлен асинхронный вебхук с результатами транзакции.