Choose an Integration Path
Mint supports three main integration styles.
1. Hosted payments
Best when you want the fastest launch and the least frontend work.
How it works:
- Your backend creates a payment with Mint.
- Mint returns a
payment_urlwhen hosted payments are enabled. - You redirect the buyer to that URL or render it as a link.
Choose this if:
- you want Mint to own the payment UI
- you want a minimal frontend integration
- you are happy to send the buyer to a Mint-hosted payment page
Read more: Hosted Payments
2. React SDK
Best when you want Mint checkout embedded inside your product.
How it works:
- Your backend creates the payment.
- Your React app uses
@mintmoney/react. - The SDK opens Mint checkout inside your app.
Choose this if:
- you have a React app
- you want tighter control over the buyer journey
- you still want Mint to handle checkout UX and payment orchestration
Read more: React SDK Quickstart
3. Direct API
Best when you want full control over frontend and orchestration.
How it works:
- Your backend creates payments directly with Mint.
- Your frontend and backend decide how to present payment status and next steps.
- You build more of the flow yourself.
Choose this if:
- you need a heavily custom UX
- you want Mint as a payment backend, not a frontend component
- you are comfortable owning more integration logic
Recommended defaults
| Use case | Recommended path |
|---|---|
| Fastest path to launch | Hosted payments |
| React product, embedded checkout | React SDK |
| Full custom payment UX | Direct API |
One rule that does not change
No matter which path you choose, payment creation should happen on your backend using your Mint secret key.