What is TokenFlight?
TokenFlight Embed is a payment widget for token flows. You add it to your app, choose the flow you need, connect a wallet adapter, and let users pay, swap, or deposit with supported tokens.
What it does
TokenFlight helps your app handle three product jobs:
| Job | Use when | Main page |
|---|---|---|
| Receive / checkout | Your app needs an exact token amount, such as 100 USDC | Receive / Checkout |
| Swap | The user chooses what they pay and previews the output | Swap |
| Card payments | Users should be able to pay by card, or choose card vs crypto | Card Payments |
Crypto wallet flows require a wallet adapter. Card-only checkout is the main exception.
How it works
At a high level:
- Your app renders the widget with tokens, amount, and flow config.
- The widget requests quotes from the configured API.
- A wallet adapter connects the user's wallet for crypto flows.
- The widget builds, submits, and tracks the order.
- Your frontend receives callbacks for UI updates.
- Your backend verifies important payments before unlocking value.
How to read these docs
Start with the path that matches your question:
| Question | Read |
|---|---|
| I am new and want the first working widget | Getting Started |
| I do not know which product flow I need | Choose your flow |
| I do not know which API style to use | Choose your API |
| I need wallet connection to work | Why wallet adapters |
| I want code for my framework | Examples |
| I am preparing for launch | Backend Verification and Troubleshooting |
Important words
flow: the product job, such as receive, swap, or card checkout.walletAdapter: the object that lets the widget connect to wallets.quote: the route and amount information returned before a user confirms.callback: a function your app receives when something happens.backend verification: your server checks payment status instead of trusting the browser.