Settlements
Settlements are transfers on Solana that happen after a payment is confirmed by the provider.
How Settlements Work
- Customer completes payment → provider confirms success
- Payment status changes to
PROCESSING - The settlement worker calculates the amounts:
- Relay net — Fee revenue for the Relay
- Client send — Client's share of the payment
- Referral fees — If applicable, split to referrer wallets
- Funds are transferred from the Relay's wallet to the Client's wallet
- Payment status changes to
COMPLETED
Fee Structure
For each payment processed through your provider, you earn a fee. The fee percentage is configured per provider and is deducted from the payment before settlement.
Example for a $100 domestic card payment with 7% fee (provider: 2.9% + $0.30):
- Payment: $100
- Provider fee: $3.20 (2.9% + $0.30)
- Your fee: $7.00 (7%)
- Your net profit: $3.80 — difference between your fee and provider + settlement costs
- Client receives: $93.00
- Settlement: $93.00 sent from your wallet to the Client's wallet on Solana
Wallet Balance
Your wallet balance consists of:
- Balance — Current balance on-chain (source of truth)
- Pending — Reserved amount for in-progress payments
Available balance = Balance - Pending
The pending amount is reserved when a payment is created and released when it completes or fails.
Wallet Transactions
The Deposit page shows your wallet's transaction history:
| Type | Description |
|---|---|
| In | Incoming funds (settlement earnings) |
| Out | Outgoing funds (withdrawals, client settlements) |
Each transaction shows the Solana transaction signature, amount, and timestamp.
Wallet balances are fetched from the Solana blockchain in real-time. There may be a brief delay between a settlement completing and the balance updating in the dashboard.