Skip to main content
Marketplace mode lets your organization collect fees on payments routed through Meridian while sending the remaining payout to a separate recipient wallet. Command Centre settings page showing Marketplace toggle, Marketplace Fee input, and Save Changes button

​
Enable marketplace mode

1

Open Settings

Sign in to Meridian Command Centre and open Settings under Financial Services.
2

Turn on Marketplace

Toggle Marketplace on.
3

Set your fee

Enter your fee in basis points. Example: 500 bps = 5%.
4

Save changes

Click Save Changes to apply the setting to your organization.
Older internal messages may call this “Platform” mode. In Command Centre the setting is labeled Marketplace.

​
Update your x402 payment requirements

Keep payTo pointed at the Meridian facilitator address for the target network. Use extra.creditedRecipient to tell Meridian which wallet should receive the net payout. Below is a paymentRequirements example used for MegaETH: 
const paymentRequirements = {
  amount: value.toString(),
  recipient: address,
  network: "megaeth",
  scheme: "exact",
  maxAmountRequired: value.toString(),
  resource: `${FACILITATOR_URL}/v1/samples`,
  description: `Payment for ${formatUnits(value, TOKEN_DECIMALS)} ${TOKEN_SYMBOL}`,
  mimeType: "application/json",
  payTo: MEGAETH_PROXY_ADDRESS,
  asset: MEGAETH_FORWARDER_ADDRESS,
  extra: {
    creditedRecipient: recipientAddress,
    name: usdmDomain.name,
    version: usdmDomain.version,
    destinationChainId: MEGAETH_CHAIN_ID,
  },
};

​
How payouts work

  • payTo remains the Meridian facilitator, not the seller wallet.
  • extra.creditedRecipient receives the payment amount remaining after fees.
  • Your marketplace fee accrues inside the facilitator contract as a platform balance for your organization.
  • Fees do not automatically land in your wallet. Withdraw them from the Settings page using Withdraw Marketplace Fees, or withdraw them directly on-chain from the proxy contract.
If your marketplace fee is 500 bps, Meridian records 5% of each payment as marketplace fees. In the simple case where no other fee applies, the remaining 95% is settled to creditedRecipient.
Marketplace fees are tracked on-chain inside the facilitator and can later be withdrawn to your connected wallet from Command Centre.

​
Withdraw marketplace fees on-chain

You can also withdraw accumulated marketplace fees directly from the Meridian proxy contract by calling: 
withdrawPlatformFees(address token)
Call this function on the network’s Meridian proxy/facilitator address from the same wallet address that is configured as the marketplace platform address. The platform address is inferred from msg.sender, so it is not passed as a function argument. 
await facilitator.write.withdrawPlatformFees([tokenAddress]);
Use the token address for the asset in which fees accrued on that network (for example USDC, or USDm on MegaETH).