Partner payout wallet

Your payout wallet, labelled PartnerFee address in the partner portal, is the fee receiver your app uses in its SDK integration: partnerFee.address. Add that same address in the portal to track your fees, track your volume, and claim your fees. The integration sets where fees go. The portal reads the address you register; saving an address there does not change the fee receiver or fee percentage in your app. If someone else built your integration, ask them for its partnerFee.address before saving it. There is a developer section below.

​

What the payout wallet is

It is an EVM wallet address — the 0x… kind — that your team controls and uses as partnerFee.address in the integration. Registering it in the portal does not create a new wallet. You give the portal that same address to:

• Track your fees and volume. View the activity associated with that fee receiver.
• Claim your fees. Connect the matching wallet to claim its accumulated fees.

​

Adding it in the portal

During sign-up. If you are already integrated, enter the same EVM address used as partnerFee.address in your SDK integration. Confirm that it is the PartnerFee address your app uses, then select Save PartnerFee address. If you are not integrated yet, use Not integrated yet? and add the address once your integration is configured. Adding it later. Go to Monitored Wallets in the portal:

1. Open Monitored Wallets and pick your organisation.
2. Paste the exact address your integration uses as partnerFee.address. The label box is optional — it is just a name so you recognise the row later.
3. Click Add.

Two things to know before you click: Your organisation has one payout address.

​

Changing your fee wallet

Your developer can change the fee receiver in the SDK integration for future intents. When that happens, update the address registered in the portal to match; contact the team if you need help doing this. Updating the portal alone does not change where your app sends fees. Fees already credited to the previous address stay there. Keep access to that wallet to claim them.

​

Where your fees build up

Your fees all collect on Sonic, one of the networks SODAX runs on. It does not matter which networks the actual swap went between — the fee always ends up on Sonic. Nowhere else holds it. They pile up separately for each token. You will see a list of balances rather than one number, and the same token can show up more than once: USDC that came from a swap on Arbitrum and USDC that came from a swap on Base are two separate balances. The portal stacks them together under the token name so the list stays readable. Money shows up here as soon as a swap through your app charges a fee. It sits there safely until you cash out — nothing expires, and nothing gets swept up automatically.

​

Choosing where you get paid

Before you can cash anything out, tell the portal where to send it. That is the Payout destination box in the Fees panel, and it asks for three things: Saving this costs one small transaction on Sonic, because your choice is recorded on the blockchain rather than in our database. Your payout wallet has to approve that transaction itself, which also means nobody else on your team can change where your money goes. They can see the setting, but not touch it. Changing it affects your next payout. Anything already on its way is unaffected.

​

Which networks you can be paid on

Sonic is the cheapest and fastest, because your fees are already sitting there and nothing has to move between networks. Every other choice adds a hop. NEAR and Stacks are not payout options at the moment, even though you can swap to them through SODAX. The list in the portal is always the current one — it updates itself as networks become available.

​

Claiming your fees

Cashing out is something you do by hand, one token at a time. There is no “claim everything” button.

​

Before your first claim

​

Claiming a token

1. Find the token in your list of fees.
2. Click Approve, and confirm in your wallet. This is a one-off permission that lets SODAX move that particular token on your behalf when you claim. You only ever do it once per token — later claims of the same token skip this step.
3. Click Claim, and confirm what the portal shows you.
4. Approve the transaction in your wallet.

A claim always takes the whole balance of that token. You cannot cash out part of it. From there it happens on its own: the token gets swapped to USDC at the best price available, and the USDC is sent to your receiving address on the network you chose. Cashing out to a different network than Sonic means it has to travel, so give it a few minutes rather than expecting it the second you sign.

​

The minimum claim amount

Very small balances cannot be cashed out. They show as Below minimum and simply wait in your account until they grow — either as more fees come in, or as the token’s price moves. This is not us being awkward. A tiny claim can cost more in transaction fees than it is worth, and below roughly a dollar nobody will take the other side of the swap at all, so it would just fail.

​

If something is not working

Still stuck? Talk to us — include your payout address and we can look at what happened.

​

For your developer

The portal’s PartnerFee address is the address field of the fee configuration used by your integration. For SDK swaps, this is normally swaps.partnerFee.address, or fee.address if you use the global fee configuration. A per-intent partnerFee override takes precedence, so register the receiver your app actually uses. Reading balances, setting the payout destination, approving, claiming, and recovering a claim that got stuck are available through sodax.partners.feeClaim in @sodax/sdk.

​

Get help