Payments

Every fill is paid with a normal USDC transfer on Solana mainnet, from the buyer's wallet straight to the provider's payout wallet. StellarBook never touches the funds.

What a valid payment looks like

One confirmed Solana transaction that:

  • is signed by the wallet that posted the order (the wallet that owns the API key, or the signed-in wallet in the app);
  • moves at least amount_micro units of USDC (mint EPjF…Dt1v) out of that wallet;
  • delivers at least that amount to the provider's recipient wallet (its associated token account);
  • contains an SPL Memo instruction whose text includes the fill's memo, for example stellarbook:fill_…;
  • has not already been used to settle another fill.

We read the confirmed transaction from Solana and compare token balances before and after. If any condition fails, the settle call returns 402 payment_not_verified with the reason.

Payment window

A fill can be paid for 10 minutes after the match. After that it becomes expired and a new order is needed. Paying after expiry is not refundable by StellarBook, because the money went directly to the provider; contact the provider.

Fees

StellarBook charges no protocol fee. You pay the Solana network fee (a fraction of a cent). If the provider has never received USDC before, the first payment also creates its token account, which costs about 0.002 SOL in rent.

Why no escrow

Escrow contracts hold everyone's money in one place, which makes them the most attractive target in any system. Direct payment removes that risk entirely. The trade-off is that the buyer pays before receiving the result; we keep that risk small by verifying providers on every quote, publishing their delivery statistics, and pausing providers that fail to deliver.