Toggle the merchant kill-switch (admin-only, no body)
Toggles the kill-switch state — a bodyless toggle (every call flips disabled ↔ enabled); there are NO request fields such as `active` or `reason`. Admin-only: requires a platform-operator JWT session (role `admin`/`platform_admin`); HMAC pairs and merchant cabinet sessions get 403. Admin alias: `POST /api/v1/p2p/admin/merchants/{merchant_id}/kill-switch`.
/api/v1/p2p/merchants/{merchant_id}/kill-switchToggles the kill-switch state — a bodyless toggle (every call flips
disabled ↔ enabled); there are NO request fields such as active or
reason. Admin-only: requires a platform-operator JWT session (role
admin/platform_admin); HMAC pairs and merchant cabinet sessions
get 403. Admin alias:
POST /api/v1/p2p/admin/merchants/{merchant_id}/kill-switch.
Authorization
MerchantToken MerchantSignature 64-character hex public merchant token assigned during onboarding.
In: header
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
Path Parameters
Target merchant UUID.
uuidResponse Body
application/json
application/problem+json
curl -X POST "https://example.com/api/v1/p2p/merchants/497f6eca-6276-4993-bfeb-53cbbbba6f08/kill-switch"{ "merchant_id": "500924a8-3f5e-4c00-beb8-2efcde988aea", "disabled": true, "disabled_at": "2019-08-24T14:15:22Z"}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "instance": "../dictionary", "errors": [ { "field": "amount", "message": "must be greater than 0", "code": "POSITIVE_REQUIRED" } ]}Clear the merchant kill-switch POST
Nullifies `disabled_at`, re-enabling authentication.
Provision (or rotate) the merchant TRC-20 deposit address (legacy path) POST
Legacy admin-impersonation alias of the canonical `POST /api/v1/p2p/merchant/wallet/deposit-address` (same handler, same response). Lets an operator act on behalf of a merchant. With HMAC authentication the path `merchant_id` MUST match the token claims; merchant-JWT callers may only target their own merchant (IDOR guard). Claims the next BIP44 derivation index, derives the address via tron-wallet-api, and persists the address + index back to the merchant row. Previously issued addresses stay in the eternal block-polling set — deposits sent to a superseded address are still detected and credited.