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

В этом руководстве — первый платёж через API Datagio Finance.

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

Для запросов сервер-сервер используйте аккаунтные ключи:

• X-API-Key: публичный ключ (pk_live_...).
• X-API-Secret: секрет (sk_live_...).

Их можно создать в личном кабинете. В теле запроса передайте shop_id одобренного магазина.

Кассовый ключ dg_live_... тоже подходит: тогда магазин берётся из ключа, эндпоинт — POST /api/v1/merchant/payments.

[!WARNING] Никогда не передавайте секрет на стороне клиента. Только ваш бэкенд.

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

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": 1,
    "amount": 1500,
    "description": "Оплата подписки"
  }'

Пример ответа 201 Created

{
  "id": "9c0526fe-0e45-423d-91ca-368e98b8ea96",
  "shop_id": 1,
  "amount": "1500.00",
  "currency": "RUB",
  "fee_payer": "merchant",
  "payer_amount": "1500.00",
  "merchant_credit": "1425.00",
  "platform_revenue": "75.00",
  "status": "pending",
  "checkout_url": "https://datagio.finance/pay/9c0526fe-0e45-423d-91ca-368e98b8ea96",
  "created_at": "2026-09-17T17:50:00+03:00"
}

checkout_url совпадает с pay_url / paymentUrl.

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

Перенаправьте плательщика на checkout_url. После оплаты на ваш сервер придёт вебхук payment.succeeded.