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

Для проверки состояния транзакции вы можете получить информацию о конкретной платёжной ссылке по её идентификатору или запросить список последних созданных ссылок.

---

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

Для проверки состояния конкретного платежа отправьте HTTP GET-запрос с указанием ID ссылки.

HTTP Запрос

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

Параметры пути (Path parameters)

• id (string, UUID, обязательный): Уникальный идентификатор платёжной ссылки.

Пример запроса (API-ключ)

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"

Ответ API (200 OK)

Возвращает полный объект платёжной ссылки (структура полей совпадает с ответом на создание платежа).

---

2. Получение списка платёжных ссылок

Вы можете получить до 100 последних созданных ссылок (новые отображаются вверху списка).

HTTP Запрос

По API-ключу (сервер-сервер):

GET /merchant/v1/payment-links

По JWT-токену (дашборд):

GET /api/v1/payment-links

Пример запроса (API-ключ)

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"

Ответ API (200 OK)

Возвращает объект, содержащий массив payment_links.

{
  "payment_links": [
    {
      "id": "9c0526fe-0e45-423d-91ca-368e98b8ea96",
      "shop_id": "b79ffcef-5f6e-4adf-aa5f-e885b4d282d9",
      "merchant_id": "c80ffcef-5f6e-4adf-aa5f-e885b4d282d9",
      "order_id": "ORDER-12345",
      "description": "Оплата заказа №12345",
      "currency": "RUB",
      "amount": "1000.00",
      "fee_percent_bp": 100,
      "fee_payer": "merchant",
      "payer_amount": "1000.00",
      "merchant_credit": "990.00",
      "platform_revenue": "10.00",
      "status": "paid",
      "expires_at": "2026-07-23T18:50:53Z",
      "paid_at": "2026-07-23T17:55:12Z",
      "created_at": "2026-07-23T17:50:53Z",
      "updated_at": "2026-07-23T17:55:12Z"
    }
  ]
}

---

Статусы платёжной ссылки (status)

Платёжная ссылка в процессе своего жизненного цикла может принимать следующие значения статуса:

• pending — ссылка создана и ожидает оплаты от покупателя (выбора способа оплаты или завершения транзакции).
• paid — оплата успешно подтверждена платежным шлюзом, средства зачислены на баланс мерчанта.
• expired — истёк срок жизни платёжной ссылки. Оплата по ней больше невозможна.
• canceled — платёжная ссылка отменена мерчантом или системой.
• failed — произошла неустранимая ошибка при проведении транзакции платежным шлюзом.

---

Возможные ошибки

При запросе статуса или списка могут возвращаться следующие коды ошибок:

• 401 Unauthorized (unauthorized): Неверный API-ключ или JWT-токен.
• 403 Forbidden (forbidden): Попытка запросить платёжную ссылку, принадлежащую другому мерчанту.
• 404 Not Found (not_found): Платёжная ссылка с указанным ID не найдена в системе.