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

Опрос состояния платежа по UUID из ответа создания. Для финального результата предпочтительнее webhook.

GEThttps://api.protopays.io/api/v1/payments/{uuid}

Запрос

HMAC как при создании (для GET — от пустой строки). UUID — из data.id. Чужой платёж → 404.

Пример

curl

curl -sS -X GET 'https://api.protopays.io/api/v1/payments/550e8400-e29b-41d4-a716-446655440000' \
  -H 'Accept: application/json' \
  -H 'X-Merchant-Key-Id: <KEY_ID>' \
  -H 'Signature: <SIGNATURE>'

Ответ

Как в create. Статус строчными; в webhook — ЗАГЛАВНЫМИ.

json

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "orderId": "order-001",
    "status": "pending",
    "amount": "1000.00",
    "currency": "RUB",
    "method": "sbp",
    "requisite": {
      "value": "+79991234567",
      "holder": "И. Иванов",
      "bank": "Пример банк"
    },
    "paymentPageUrl": "https://pay.protopays.io/r/rpt_<token>",
    "expiresAt": "2026-04-20T15:30:00+00:00"
  }
}

Статусы

pending — ждёт оплаты
completed — успех
failed / cancelled
requisite_unavailable — реквизиты не выдали
appeal — спор