Интеграция API

Статус платежа

Проверка текущего статуса транзакции

Статус и список платёжных ссылок

Можно получить одну ссылку по ID, список последних или отменить ещё не оплаченную.


1. Получение одной платёжной ссылки по ID

GET /merchant/v1/payment-links/{id}

  • id (string, UUID) — идентификатор ссылки.
curl -X GET https://api.datagio.finance/merchant/v1/payment-links/9c0526fe-0e45-423d-91ca-368e98b8ea96 \
  -H "X-API-Key: pk_live_your_public_key" \
  -H "X-API-Secret: sk_live_your_secret_key"

Ответ 200 — тот же объект, что при создании платежа.


2. Список платёжных ссылок

  • По API-ключу: GET /merchant/v1/payment-links
  • По сессии: GET /api/v1/payment-links

В JSON массив payment_links (алиас payments).

curl -X GET https://api.datagio.finance/merchant/v1/payment-links \
  -H "X-API-Key: pk_live_your_public_key" \
  -H "X-API-Secret: sk_live_your_secret_key"
{
  "payment_links": [
    {
      "id": "9c0526fe-0e45-423d-91ca-368e98b8ea96",
      "shop_id": 1,
      "order_id": "ORDER-12345",
      "amount": "1000.00",
      "fee_payer": "merchant",
      "payer_amount": "1000.00",
      "merchant_credit": "950.00",
      "status": "paid",
      "paid_at": "2026-09-17T17:55:12+03:00",
      "created_at": "2026-09-17T17:50:00+03:00"
    }
  ]
}

3. Отмена

POST /merchant/v1/payment-links/{id}/cancel (и тот же путь в /api/v1/...) — только статус pending.


Статусы (status)

  • pending — ожидает оплаты.
  • paid — оплата подтверждена, средства зачислены.
  • expired — срок ссылки истёк.
  • canceled — отменена.
  • failed — ошибка проведения.

Ошибки

  • 401 (common.err.unauthorized): неверный ключ или сессия.
  • 403 (common.err.forbidden): ссылка другого мерчанта.
  • 404 (common.err.not_found): ссылка не найдена.