S
docs.syncra.money
API ReferenceMerchant APIApi referenceReference

List the tenant's active payment methods

Returns the ACTIVE payment methods configured for the authenticated merchant's tenant: `id` (UUID), `slug`, `name`, `requisite_types`, `currency_code` and `status`. This is the **canonical method catalog**: the unified method reference — UUID (`id`) or slug (`slug`) — accepted by BOTH `POST /deals/payin` (`payment_method_id`) and `POST /deals/payout` (`payment_method`); both formats resolve to the same row. The method's currency must match the deal currency (PayOut rejects a mismatch with HTTP 400). `GET /banks` does NOT return method identifiers — its `methods` field carries `RequisiteType` values only.

GET/api/v1/p2p/merchant/payment-methods

Returns the ACTIVE payment methods configured for the authenticated merchant's tenant: id (UUID), slug, name, requisite_types, currency_code and status.

This is the canonical method catalog: the unified method reference — UUID (id) or slug (slug) — accepted by BOTH POST /deals/payin (payment_method_id) and POST /deals/payout (payment_method); both formats resolve to the same row. The method's currency must match the deal currency (PayOut rejects a mismatch with HTTP 400). GET /banks does NOT return method identifiers — its methods field carries RequisiteType values only.

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

Response Body

application/json

application/problem+json

curl -X GET "https://example.com/api/v1/p2p/merchant/payment-methods"
{  "data": [    {      "id": "550e8400-e29b-41d4-a716-446655440000",      "slug": "express-havale",      "name": "Havale Express (TRY)",      "requisite_types": [        "BANK_TRANSFER"      ],      "currency_code": "TRY",      "status": "ACTIVE"    },    {      "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",      "slug": "sbp_rub",      "name": "SBP",      "requisite_types": [        "SBP"      ],      "currency_code": "RUB",      "status": "ACTIVE"    }  ]}
{  "type": "../dictionary",  "title": "string",  "status": 0,  "detail": "string",  "instance": "../dictionary",  "errors": [    {      "field": "amount",      "message": "must be greater than 0",      "code": "POSITIVE_REQUIRED"    }  ]}