Overview
Mint gives you a few different ways to accept payments, depending on how much UI and payment orchestration you want to own.
Core concepts
Checkout
A checkout is the merchant configuration that defines how payments should be accepted and settled.
Payment
A payment is a single payment intent created against a checkout. It includes the amount, currency, and optional metadata such as order_id, customer_id, return_url, and line_items.
Payment URL
If hosted payments are enabled, Mint returns a payment_url when a payment is created. You can redirect the buyer to that URL instead of embedding the SDK yourself.
Payment attempt
When a buyer starts paying, Mint creates a payment attempt for the selected method. In the crypto flow, Mint computes the destination address and the settlement amount.
Payment status
The main payment statuses are:
pendingconfirming_paymentpaidfailed
What the React SDK gives you
The @mintmoney/react package provides the client-side pieces needed to embed Mint checkout in a React application:
createConfig(...)MintMoneyProviderCheckoutgetPaymentById(...)
The SDK is designed to work with a server-side payment creation step. Your backend creates the payment with your Mint secret key, and the frontend uses the SDK with your public key.