Partner program

NavoSwap partners embed swap functionality in wallets, sites, and backends. You get JWT-authenticated access to partner APIs, rotatable API keys for attributing public swap traffic, a dashboard for volume and earnings, and an affiliate program that accrues commission when referred swaps complete.

Partner onboarding (high level)

Verify email

Rotate API keys

Ship integration

Use the live partner app for signup URLs, 2FA, and affiliate terms acceptance before payouts.

What partners receive

Secure API access: Create API keys from the partner profile; keys identify your integration on POST /swap/create.
Analytics: Time-series and totals for orders, volume, and affiliate USD via GET /partners/analytics (dashboard in the app).
Order visibility: Filterable order history tied to your partner ID.
Optional 2FA: TOTP-based two-factor authentication for the partner account.
Affiliate economics: Per-partner commission rate in basis points (bps), configured by operations; earnings accrue on completed swap volume (USD notional on the from-leg). See Affiliate, ledger & payouts.

Partner account authentication

Dashboard and affiliate APIs require a JWT access token (and optional refresh token). Typical flows:

POST /partners/signup → email verification code → POST /partners/verify-email
POST /partners/signin: Returns access + refresh tokens (2FA code when enabled).
POST /partners/auth/refresh: Rotate access token.
POST /partners/auth/token: Exchange a partner API key for JWT access (for server-to-server dashboard operations).
POST /partners/auth/logout: Invalidate refresh session.
Password recovery: POST /partners/forgot-password, POST /partners/reset-password.
Optional TOTP: POST /partners/2fa/setup, …/enable, …/disable.

Other JWT routes include GET /partners/profile, POST|GET /partners/api-keys, GET /partners/orders (paginated), GET /partners/analytics?days=30, and POST /partners/change-password.

Authenticated requests send Authorization: Bearer <access_token>. API keys used for swap attribution are separate; see API integration.

Documentation map

API integration & attribution: header x-navoswap-api-key, SDK usage, server-side guidance.
Affiliate, ledger & payouts: Commission math, ledger entries, payout requests, crypto-only payouts, minimum thresholds.
Webhooks & verification: Events, HMAC verification, endpoint management.
HTTP API overview and JavaScript SDK: Public swap routes and typed client.

Support

For integration help, contact support@navoswap.com.