Quote payment fees
PaymentsAPI REFERENCE
Quote payment fees
POST
/v1/payments/quoteReturns the platform fee, estimated network fee, and net amount for a payment of `amount` in `asset`, without creating anything. All monetary fields are integer strings in the asset's smallest unit.
Example request
A minimal request you can copy and run.
curl -X POST https://api.suward.com/v1/payments/quote \ -H "X-Api-Key: $SUWARD_API_KEY" \ -H "Content-Type: application/json" \ -d '{"asset":"USDT_ETHEREUM","amount":"100000000","networkFeePayer":"merchant","serviceFeePayer":"merchant"}'Request body
| Name | Type | Required | Description |
|---|---|---|---|
| asset | yes | Asset identifier (see GET /v1/assets for the live list). | |
| amount | string | yes | Merchant base amount, integer string in the asset's smallest unit. Example: "5000000" = 5 USDT. The response returns the derived gross (what the customer pays) and netAmount (what the merchant receives). |
| networkFeePayer | no | Who bears the network (gas) fee. Default merchant. | |
| serviceFeePayer | no | Who bears the platform (service) fee. Default merchant. |
Request · JSON
{ "asset": "USDT_ETHEREUM", "amount": "100000000", "networkFeePayer": "merchant", "serviceFeePayer": "merchant"}Response
| Name | Type | Required | Description |
|---|---|---|---|
| asset | no | Asset the quote is denominated in, echoed from the request. | |
| amount | string | no | Gross amount, integer string in the asset's smallest unit. |
| fee | string | no | Platform fee: 0.4% of the amount, minimum $1 equivalent. Integer string in the asset's smallest unit. |
| networkFee | string | no | Estimated on-chain (gas) cost, deducted from the received amount. Integer string in the asset's smallest unit. |
| netAmount | string | no | Amount the merchant receives after all fees. Integer string in the asset's smallest unit. |
| gross | string | no | Amount the customer pays: base plus any customer-paid fees. Integer string in the asset's smallest unit. |
| quotedPrice | string | no | USD price used for this quote, decimal string. Not locked — the binding price is captured when the payment is created. |
Response · JSON
{ "asset": "USDT_ETHEREUM", "amount": "100000000", "fee": "1000000", "networkFee": "150000", "netAmount": "100000000", "gross": "string", "quotedPrice": "string"}