S
docs.syncra.money
API ReferenceMerchant APIApi referenceReference

List available banks and payment methods

Returns the active banks / payment methods configured for the tenant, optionally filtered by country and currency.

GET/api/v1/p2p/merchant/banks

Returns the active banks / payment methods configured for the tenant, optionally filtered by country and currency.

Authorization

MerchantToken MerchantSignature
X-Merchant-Token<token>

64-character hex public merchant token assigned during onboarding.

In: header

X-Signature<token>

Stripe-style HMAC-SHA256 signature. Format: t=<unix_seconds>,v1=<hex_hmac_sha256> where hex_hmac = HMAC-SHA256(webhook_secret, "<unix_seconds>.<raw_body>"). Replay window: 5 minutes (60s future drift tolerated).

In: header

Query Parameters

country?string

ISO 3166-1 alpha-2 country code (e.g. RU).

currency?string

ISO 4217 currency code (e.g. RUB).

Response Body

application/json

application/problem+json

curl -X GET "https://example.com/api/v1/p2p/merchant/banks?country=RU&currency=RUB"
{  "data": [    {      "bank_name": "sberbank",      "display_name": "Sberbank",      "country": "RU",      "methods": [        "BANK_CARD",        "SBP"      ]    },    {      "bank_name": "tinkoff",      "display_name": "T-Bank",      "country": "RU",      "methods": [        "BANK_CARD",        "SBP",        "E_WALLET"      ]    }  ]}
{  "type": "../dictionary",  "title": "string",  "status": 0,  "detail": "string",  "instance": "../dictionary",  "errors": [    {      "field": "amount",      "message": "must be greater than 0",      "code": "POSITIVE_REQUIRED"    }  ]}