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

GET/api/v1/p2p/merchant/banksСтейдж

Канонический справочник банков тенанта (bank-routing). bank_name — МАШИННЫЙ код банка платформы (не отображаемое имя): его передают в target_bank заявок и по нему рисуют 1click-кнопки. Доступность (payin_available / payout_available) вычисляется по фактическому покрытию — «мёртвая кнопка» невозможна.

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

country?string

Код страны ISO 3166-1 alpha-2 (например RU).

currency?string

Код валюты ISO 4217 (например RUB).

method?string

UUID или слаг метода — «банки, доступные для КОНКРЕТНОГО метода» (источник кнопок для sbp_rub, iban_try, ...). Без параметра — весь справочник тенанта.

direction?string

Направление: PAY_IN (кнопки депозита) или PAY_OUT (банки выплаты). Без параметра — обе стороны; различайте по флагам payin_available / payout_available.

Value in

"PAY_IN"
"PAY_OUT"

Response Body

`application/json`

`application/problem+json`

curl -X GET "https://example.com/api/v1/p2p/merchant/banks?country=RU&currency=RUB&method=sbp_rub&direction=PAY_IN" \  -H "X-Merchant-Token: <MERCHANT_TOKEN>" \  -H "X-Timestamp: <UNIX_TIMESTAMP>" \  -H "X-Signature: t=<UNIX_TIMESTAMP>,v1=<HEX_HMAC_SHA256>"

{  "data": [    {      "bank_name": "sber",      "display_name": "Сбербанк",      "country": "RU",      "methods": [        "SBP"      ],      "payin_available": true,      "payout_available": false    },    {      "bank_name": "tbank",      "display_name": "Т-Банк",      "country": "RU",      "methods": [        "SBP",        "BANK_CARD"      ],      "payin_available": true,      "payout_available": false    }  ]}

{  "type": "../dictionary",  "title": "string",  "status": 0,  "detail": "string",  "instance": "../dictionary",  "errors": [    {      "field": "amount",      "message": "must be greater than 0",      "code": "POSITIVE_REQUIRED"    }  ]}

Authorization

Query Parameters

Response Body

200application/json

401application/problem+json

`application/json`

`application/problem+json`