Интеграция 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): ссылка не найдена.