PayWeaveReferrals
PayWeave includes a built-in referral system powered by on-chain split payments. Anyone can earn a percentage of payments by sharing payment URLs with a referral parameter.
How it works
Append ?ref=WALLET_ADDRESS to any PayWeave payment URL — gateways, functions, or file downloads. When an agent or user pays through that link, the referrer wallet automatically receives a split of the payment.
The referral reward is settled in the same on-chain transaction as the original payment. No claiming, no delays, no separate payout process.
Example
A gateway endpoint at https://api.payweave.dev/gw/abc123/search costs $0.10 per request. Share it as:
https://api.payweave.dev/gw/abc123/search?ref=0xYourWalletAddress
On the Free plan (3% platform fee) with default 0.5% referral:
| Recipient | Amount | Percentage |
|---|---|---|
| Workspace owner | $0.0965 | 96.5% |
| PayWeave (platform fee) | $0.003 | 3% |
| Referrer | $0.0005 | 0.5% |
Configuration
Workspace owners can configure referral settings from Settings in the dashboard:
| Setting | Default | Range |
|---|---|---|
| Referral enabled | Yes | On / Off |
| Referral percentage | 0.5% | 0.1% — 10% |
When referrals are disabled, the ?ref= parameter is silently ignored — no error, no split.
Referral tracking
Every transaction records the referrer wallet address. You can see which transactions included referral payouts in the Transactions page.
Supported payment URLs
The ?ref= parameter works on all PayWeave payment endpoints:
| Type | URL pattern |
|---|---|
| Gateways | /gw/:gatewayId/*?ref=0x... |
| Functions | /fn/:functionId/*?ref=0x... |
| Files | /fl/:collectionId/:fileName?ref=0x... |
| SDK charge | /api/mpp/app/:appId/charge?ref=0x... |
Validation
The referral address must be a valid EVM address (42-character hex string starting with 0x). Invalid addresses are silently ignored. Self-referral (where the referrer address equals the workspace wallet) is allowed — the split simply returns to the workspace owner.