Quote payment fees

Returns 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.

POST/v1/payments/quoteAPI key

Request body

Field	Type	Description
`asset`required	AssetID	Asset identifier (see GET /v1/assets for the live list).
`asset` values AssetID `USDT_ETHEREUMUSDT_ARBITRUMUSDT_OPTIMISMUSDT_BASEUSDT_BSCUSDT_PLASMAUSDT_POLYGONUSDC_ETHEREUMUSDC_ARBITRUMUSDCE_ARBITRUMUSDC_OPTIMISMUSDC_BASEUSDC_BSCUSDC_PLASMAUSDC_POLYGONETH_ETHEREUMETH_ARBITRUMETH_OPTIMISMETH_BASEXPL_PLASMABNB_BSCPOL_POLYGONTESTCOIN_ETHEREUMTESTCOIN_OPTIMISMTESTCOIN_PLASMATESTSTABLECOIN_ETHEREUMTESTSTABLECOIN_OPTIMISMTESTSTABLECOIN_PLASMA`
`amount`required	string	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`optional	FeePayer	Who bears the network (gas) fee. Default merchant.
`networkFeePayer` values FeePayer `merchantcustomer`
`serviceFeePayer`optional	FeePayer	Who bears the platform (service) fee. Default merchant.
`serviceFeePayer` values FeePayer `merchantcustomer`

Response

200 OK

Field	Type	Description
`asset`optional	AssetID	Asset the quote is denominated in, echoed from the request.
`asset` values AssetID `USDT_ETHEREUMUSDT_ARBITRUMUSDT_OPTIMISMUSDT_BASEUSDT_BSCUSDT_PLASMAUSDT_POLYGONUSDC_ETHEREUMUSDC_ARBITRUMUSDCE_ARBITRUMUSDC_OPTIMISMUSDC_BASEUSDC_BSCUSDC_PLASMAUSDC_POLYGONETH_ETHEREUMETH_ARBITRUMETH_OPTIMISMETH_BASEXPL_PLASMABNB_BSCPOL_POLYGONTESTCOIN_ETHEREUMTESTCOIN_OPTIMISMTESTCOIN_PLASMATESTSTABLECOIN_ETHEREUMTESTSTABLECOIN_OPTIMISMTESTSTABLECOIN_PLASMA`
`amount`optional	string	Gross amount, integer string in the asset's smallest unit.
`fee`optional	string	Platform fee: 0.4% of the amount, minimum $1 equivalent. Integer string in the asset's smallest unit.
`networkFee`optional	string	Estimated on-chain (gas) cost, deducted from the received amount. Integer string in the asset's smallest unit.
`netAmount`optional	string	Amount the merchant receives after all fees. Integer string in the asset's smallest unit.
`gross`optional	string	Amount the customer pays: base plus any customer-paid fees. Integer string in the asset's smallest unit.
`quotedPrice`optional	string	USD price used for this quote, decimal string. Not locked — the binding price is captured when the payment is created.

Errors

400 Bad Request401 Unauthorized500 Internal Server Error— each returns { errorCode, message, args? }. Codes, retries and limits: Errors & limits

All Payments endpoints

Request

terminal

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.js

const response = await fetch('https://api.suward.com/v1/payments/quote', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.SUWARD_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "asset": "USDT_ETHEREUM",
      "amount": "100000000",
      "networkFeePayer": "merchant",
      "serviceFeePayer": "merchant"
  }),
});
const data = await response.json();

main.go

package main
 
import (
	"bytes"
	"fmt"
	"io"
	"net/http"
	"os"
)
 
func main() {
	payload := []byte(`{"asset":"USDT_ETHEREUM","amount":"100000000","networkFeePayer":"merchant","serviceFeePayer":"merchant"}`)
	req, _ := http.NewRequest("POST", "https://api.suward.com/v1/payments/quote", bytes.NewReader(payload))
	req.Header.Set("X-Api-Key", os.Getenv("SUWARD_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

request.py

import requests, os
 
payload = {
    "asset": "USDT_ETHEREUM",
    "amount": "100000000",
    "networkFeePayer": "merchant",
    "serviceFeePayer": "merchant"
}
 
response = requests.post(
    'https://api.suward.com/v1/payments/quote',
    headers={'X-Api-Key': os.environ['SUWARD_API_KEY']},
    json=payload,
)
data = response.json()

Response · 200 OK

response.json

{
  "asset": "USDT_ETHEREUM",
  "amount": "100000000",
  "fee": "1000000",
  "networkFee": "150000",
  "netAmount": "100000000",
  "gross": "string",
  "quotedPrice": "string"
}

Illustrative values. Every field, type and status on this page is generated from the OpenAPI specification.

PreviousSimulate payment NextList payment transactions

Something unclear? payments@suward.com — we treat every integration question as a documentation defect.