Skip to main content

Pricing

:::info Dashboard endpoints All /v1/pricing/* endpoints resolve the partner from your dashboard bearer token. Use Authorization: Bearer $PARTNER_TOKEN. :::

Simulate a fee breakdown (dry-run, no quote created)​

curl -G "$BASE_URL/v1/pricing/simulate" \
  -H "Authorization: Bearer $PARTNER_TOKEN" \
  --data-urlencode "source_amount=150000" \
  --data-urlencode "source_currency=AED" \
  --data-urlencode "dest_currency=SGD" \
  --data-urlencode "exchange_rate=0.35" \
  --data-urlencode "customer_id=$CUSTOMER_ID"
QueryRequiredNotes
source_amountyesminor units, string
source_currencyyesasset code
dest_currencyyesasset code
exchange_rateyesmid-market rate
customer_idnoapplies per-customer overrides

Global markup​

curl "$BASE_URL/v1/pricing/markup" -H "Authorization: Bearer $PARTNER_TOKEN"
curl -X PUT "$BASE_URL/v1/pricing/markup" \
  -H "Authorization: Bearer $PARTNER_TOKEN" -H "Content-Type: application/json" \
  -d '{ "kind": "BPS", "value": 20 }'

kind: BPS (basis points; 20 = 0.20%) or FLAT (minor units; requires currency). Optional min_fee, max_fee (minor units). All math is integer/bps — no floats.

Corridors & per-customer overrides​

curl "$BASE_URL/v1/pricing/corridors" -H "Authorization: Bearer $PARTNER_TOKEN"
curl "$BASE_URL/v1/pricing/customers" -H "Authorization: Bearer $PARTNER_TOKEN"
curl -X PUT    "$BASE_URL/v1/pricing/customers/$CUSTOMER_ID/markup" \
  -H "Authorization: Bearer $PARTNER_TOKEN" -H "Content-Type: application/json" \
  -d '{ "kind": "BPS", "value": 10 }'
curl -X DELETE "$BASE_URL/v1/pricing/customers/$CUSTOMER_ID/markup" \
  -H "Authorization: Bearer $PARTNER_TOKEN"

Next steps​