Marketplace take-rate payout API

Breaks a gross sale into platform commission, payment processing (pct + fixed), and other fees, returning seller net payout and effective total take-rate. Answers 'What is my net payout after marketplace fees?', 'What is the effective take-rate?'.

Price$0.02per request

MethodPOST

Route/v1/commerce/marketplace-payout

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

commercemarketplacetake-ratepayoutcommissionprocessing-feesellerfees

API URLhttps://x402.hexl.dev/v1/commerce/marketplace-payout

Integration docs

Example request

{
  "grossSale": 100,
  "commissionPct": 15,
  "processingPct": 2.9,
  "processingFixed": 0.3
}

Example response

{
  "grossSale": 100,
  "commission": 15,
  "commissionPct": 15,
  "processingFee": 3.2,
  "otherFees": 0,
  "totalFees": 18.2,
  "sellerPayout": 81.8,
  "effectiveTakeRatePct": 18.2,
  "interpretation": "Gross $100 − commission $15 − processing $3.2 = payout $81.8 (effective take 18.2%)."
}

Input schema

{
  "type": "object",
  "required": [
    "grossSale",
    "commissionPct"
  ],
  "properties": {
    "grossSale": {
      "type": "number",
      "examples": [
        100
      ]
    },
    "commissionPct": {
      "type": "number",
      "examples": [
        15
      ]
    },
    "processingPct": {
      "type": "number",
      "examples": [
        2.9
      ]
    },
    "processingFixed": {
      "type": "number",
      "examples": [
        0.3
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}