S
docs.syncra.money
Профиль мерчанта
GET/api/v1/p2p/my-merchantСтейдж

Самостоятельное чтение СОБСТВЕННОГО профиля мерчанта: идентификация, представление api-credentials, webhook URL, redirect-URL, IP whitelist, лимиты сделок (deal_min_amount / deal_max_amount / daily_deal_amount_limit — присутствуют только когда заданы) и поля баннера kill_switch / kill_switch_reason. Двойная аутентификация: JWT кабинета (Authorization: Bearer, роль merchant) ИЛИ HMAC-пара мерчанта — область видимости резолвится из предъявленных учётных данных.

Authorization

AuthorizationBearer <token>

JWT сессии кабинета (заголовок Authorization, схема Bearer) — используется эндпоинтом /api/v1/p2p/my-merchant.

In: header

Response Body

application/json

application/problem+json

curl -X GET "https://example.com/api/v1/p2p/my-merchant" \  -H "X-Merchant-Token: <MERCHANT_TOKEN>" \  -H "X-Timestamp: <UNIX_TIMESTAMP>" \  -H "X-Signature: t=<UNIX_TIMESTAMP>,v1=<HEX_HMAC_SHA256>"
{  "merchant": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "name": "string",    "email": "string",    "status": "string",    "kill_switch": true,    "kill_switch_reason": "string",    "balance_usdt": "string",    "escrow_usdt": "string",    "trc20_address": "string",    "project_url": "string",    "checkout_brand_name": "string",    "success_redirect_url": "string",    "fail_redirect_url": "string",    "finance_chat_id": "string",    "appeal_chat_id": "string",    "ip_whitelist": [      "string"    ],    "api_token": "string",    "withdrawal_address": "string",    "moderation_status": "string",    "api_version": "string",    "webhook_url": "string",    "created_at": "2019-08-24T14:15:22Z",    "updated_at": "2019-08-24T14:15:22Z",    "deal_min_amount": "string",    "deal_max_amount": "string",    "daily_deal_amount_limit": "string"  },  "auto_withdrawal_mode": "AUTO_UP_TO_LIMIT",  "auto_withdrawal_effective_limit_usdt_cents": "string"}
{  "type": "../dictionary",  "title": "string",  "status": 0,  "detail": "string",  "instance": "../dictionary",  "errors": [    {      "field": "amount",      "message": "must be greater than 0",      "code": "POSITIVE_REQUIRED"    }  ]}

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

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

Обновление собственного профиля и лимитов сделок (JWT кабинета) PATCH PATCH

Частичное обновление собственного профиля мерчанта: `name`, `webhook_url`, `withdrawal_address`, `success_redirect_url`, `fail_redirect_url`, `checkout_brand_name`, `finance_chat_id`, `appeal_chat_id`, `ip_whitelist` и три лимита сделок. Семантика указателей лимитов: отсутствует = без изменений, `0` = снят (NULL), `>0` = задан (в минорных единицах). Пара min/max проверяется на согласованность. Статус, балансы и комиссии — только для админов. Аутентификация: JWT кабинета.