Skip to navigation
Getting Started

Choose an Integration Path

Mint supports three main integration styles. All begin with your backend creating a payment; the difference is who owns the buyer-facing checkout.

PathBest forBuyer experienceYour work
Hosted paymentsFastest launchMint-hosted pageCreate payment and redirect
React SDKReact productsMint checkout inside your appCreate payment and render the SDK
Direct APIFully custom flowsYour UIBuild the payment lifecycle yourself

1. Hosted payments

Best when you want the fastest launch and the least frontend work.

  1. Your backend creates a payment with Mint.
  2. Mint returns a payment_url when hosted payments are enabled.
  3. You redirect the buyer to that URL.
  4. Your server fulfils only after a verified payment.paid webhook.

2. React SDK

Best when you want Mint checkout embedded inside your product.

  1. Your backend creates the payment.
  2. Your React app uses @mintmoney/react.
  3. The SDK opens Mint checkout inside your app.
  4. Your server fulfils only after a verified payment.paid webhook.

3. Direct API

Best when you want full control over the buyer UI and payment orchestration.

  1. Your backend creates payments directly with Mint.
  2. Your frontend and backend decide how to create attempts, present status, and recover from failures.
  3. You build and maintain more of the flow yourself.

One rule that does not change

No matter which path you choose, payment creation happens on your backend with your Mint secret key. Keep the key out of browser code, persist the Mint payment_id with your order, and use Webhooks for fulfilment.