S
docs.syncra.money
API ReferenceMerchant APIApi referenceFinance

Quote the withdrawal fee before submitting

Read-only quote of the withdrawal fee that applies to the authenticated merchant BEFORE they submit: the per-counterparty override when set, else the tenant base — resolved through the SAME policy resolver the money path uses, so the quote cannot drift from the charged fee. Optional `amount_usdt_cents` (USDT cents, note — whole-USDT units in the create request) also yields the net amount.

GET/api/v1/p2p/merchant/wallet/withdraw-fee

Read-only quote of the withdrawal fee that applies to the authenticated merchant BEFORE they submit: the per-counterparty override when set, else the tenant base — resolved through the SAME policy resolver the money path uses, so the quote cannot drift from the charged fee. Optional amount_usdt_cents (USDT cents, note — whole-USDT units in the create request) also yields the net amount.

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

amount_usdt_cents?integer

Optional gross withdrawal amount in USDT cents (> 0 enables net_amount_usdt_cents).

Formatint64

Response Body

application/json

application/problem+json

curl -X GET "https://example.com/api/v1/p2p/merchant/wallet/withdraw-fee?amount_usdt_cents=100000"
{  "base_fee_usdt_cents": "150",  "override_applied": false,  "total_fee_usdt_cents": "150",  "net_amount_usdt_cents": "99850"}
{  "type": "../dictionary",  "title": "string",  "status": 0,  "detail": "string",  "instance": "../dictionary",  "errors": [    {      "field": "amount",      "message": "must be greater than 0",      "code": "POSITIVE_REQUIRED"    }  ]}