Чеки по выплате

После успешного завершения выплаты (completed) мерчант может получить прямые URL на файлы чеков, которые трейдер загрузил при исполнении. Ссылки открываются без дополнительных заголовков HMAC — подпись нужна только на запрос списка URL.

GET https://api.protopays.io/api/v1/payins/{uuid}/proofs

Запрос

Те же заголовки HMAC, что при опросе статуса: X-Merchant-Key-Id и Signature от пустой строки (GET без тела). В path — uuid выплаты.

Выплата не в completed → 403, payin_proofs_not_available
Чужая выплата → 404, payin_not_found

Ответ

Поле	Тип	Обяз.	Описание
data	string[]	да	Массив абсолютных URL файлов (/storage/payin_proofs/…). Пустой массив, если чеков нет.

{
  "data": [
    "https://api.example.com/storage/payin_proofs/42/abc123.jpg",
    "https://api.example.com/storage/payin_proofs/42/def456.pdf"
  ]
}

В webhook

При COMPLETED в payin.status.updated в meta.proofUrls приходят те же прямые ссылки (если файлы есть):

"meta": {
  "reason": "optional admin comment",
  "proofUrls": [
    "https://api.example.com/storage/payin_proofs/42/abc123.jpg"
  ]
}

Заметки

Скачивание по URL — обычный GET; HMAC на файл не требуется.
Если нужен повторный список — вызовите endpoint снова после webhook.
До одобрения админом чеки через API мерчанта недоступны.