S
docs.syncra.money
Справочники
GET/api/v1/p2p/merchant/currenciesСтейдж

Справочник валют тенанта аутентифицированного мерчанта (HMAC claims или JWT кабинета): UUID, ISO 4217 alpha-код и отображаемое имя каждой ACTIVE-строки p2p_currencies. Используется для форматирования сумм выплат и выбора валюты в CreateMerchantPayOut.

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

Response Body

application/json

application/problem+json

curl -X GET "https://example.com/api/v1/p2p/merchant/currencies" \  -H "X-Merchant-Token: <MERCHANT_TOKEN>" \  -H "X-Timestamp: <UNIX_TIMESTAMP>" \  -H "X-Signature: t=<UNIX_TIMESTAMP>,v1=<HEX_HMAC_SHA256>"
{  "data": [    {      "id": "9a3f1c2e-1234-4abc-9def-56789abcdef0",      "code": "RUB",      "name": "Российский рубль",      "status": "ACTIVE"    },    {      "id": "4ac148fe-19a3-45bb-b992-019fac55b72c",      "code": "TRY",      "name": "Türk lirası",      "status": "ACTIVE"    }  ]}
{  "type": "../dictionary",  "title": "string",  "status": 0,  "detail": "string",  "instance": "../dictionary",  "errors": [    {      "field": "amount",      "message": "must be greater than 0",      "code": "POSITIVE_REQUIRED"    }  ]}

Листинг активных платёжных методов тенанта GET GET

Возвращает платёжные методы в статусе ACTIVE, настроенные для тенанта аутентифицированного мерчанта: `id` (UUID), `slug`, `name`, `requisite_types`, `currency_code` и `status`. Это **канонический каталог методов**: единая ссылка на метод — UUID (`id`) или слаг (`slug`) — принимается и `POST /deals/payin` (`payment_method_id`), и `POST /deals/payout` (`payment_method`); оба формата резолвятся в одну и ту же строку. Валюта метода должна совпадать с валютой сделки (PayOut отклоняет несовпадение с HTTP 400). `GET /banks` НЕ возвращает идентификаторы методов — его поле `methods` содержит только значения `RequisiteType`.

Ротация API-ключей POST POST

Атомарно заменяет существующие учётные данные. Возвращает новый токен и секрет. Grace-период ротации (подтверждённое поведение): исходящая пара остаётся валидной ограниченное окно (по умолчанию 15 минут, настраивается оператором через `MERCHANT_KEY_GRACE_PERIOD`, `0` отключает). Grace строго парный — в течение окна принимается только ПОЛНАЯ старая пара (старый токен + старый секрет); смешанные комбинации возвращают 401. Исходящие вебхуки подписываются НОВЫМ секретом немедленно.