S
docs.syncra.money
Доставка вебхуков
ENRU
GET/api/v1/p2p/merchant/callbacksСтейдж

Возвращает записи доставки вебхуков мерчанта с опциональной фильтрацией по сделке. Привязка-алиас: GET /api/v1/p2p/callbacks.

Authorization

MerchantToken MerchantSignature MerchantTimestamp
X-Merchant-Token<token>

Публичный токен мерчанта (64 hex-символа), выдаётся при онбординге.

In: header

X-Signature<token>

Подпись HMAC-SHA256 (единая схема для всех эндпоинтов). Формат: t=<unix_seconds>,v1=<hex_hmac_sha256> где hex_hmac = HMAC-SHA256(webhook_secret, "<unix_seconds>.<raw_body>"). Окно replay: 5 минут (допускается дрейф 60 секунд в будущее).

In: header

X-Timestamp<token>

Unix-время отправки запроса в секундах. Окно подписи: 5 минут назад / 60 секунд вперёд.

In: header

Query Parameters

deal_id?string

Фильтр записей доставки по ID сделки.

Formatuuid
page_size?integer

Максимальное число возвращаемых результатов (по умолчанию 20, максимум 100).

Formatint32
Range1 <= value <= 100
Default20

Response Body

application/json

application/problem+json

curl -X GET "https://example.com/api/v1/p2p/merchant/callbacks" \  -H "X-Merchant-Token: <MERCHANT_TOKEN>" \  -H "X-Timestamp: <UNIX_TIMESTAMP>" \  -H "X-Signature: t=<UNIX_TIMESTAMP>,v1=<HEX_HMAC_SHA256>"
{  "data": [    {      "callback_id": "f4a074ff-b67f-4fe6-8a19-9acf4989a084",      "deal_id": "2fa5b64f-5b72-4263-958e-07b76f41abe3",      "merchant_id": "500924a8-3f5e-4c00-beb8-2efcde988aea",      "callback_url": "http://example.com",      "status": "PENDING",      "retry_count": 0,      "response_code": 0,      "response_body": "string",      "next_retry_at": "2019-08-24T14:15:22Z",      "created_at": "2019-08-24T14:15:22Z"    }  ]}
{  "type": "../dictionary",  "title": "string",  "status": 0,  "detail": "string",  "instance": "../dictionary",  "errors": [    {      "field": "amount",      "message": "must be greater than 0",      "code": "POSITIVE_REQUIRED"    }  ]}

Изменение каталога платёжных методов (broadcast только для V2) Webhook Webhook

Эмитируется, когда администратор создаёт платёжный метод или обновляет его каталог-видимые поля (`name`, `status`, `requisite_types`, `is_cross_border`). Broadcast каждому ACTIVE V2-мерчанту тенанта с непустым webhook_url (legacy V1-мерчанты не получают его никогда — V1-обёртка не имеет catalog callbackType). Обновления без изменений ничего не эмитируют. Обёртка — отдельная каталог-форма: поля сделки (`amount`, `currency`, `deal_id`) отсутствуют. Это УВЕДОМЛЕНИЕ, а не источник данных: при получении перечитайте GET /api/v1/p2p/merchant/payment-methods.

Листинг диспутов GET GET

Возвращает все диспуты мерчанта с опциональной фильтрацией по статусу.