Payments & checkout

Initial subscription checkout

A standard purchase uses four checkout steps: Choose package, Addons, Billing info and Payment. The subscription is activated for the selected Discord server after Medusa verifies the payment.

1. 1Choose Basic or Advanced and monthly or yearly billing.
2. 2Choose any extra collection/token or rule capacity offered by checkout.
3. 3Complete the billing-information form.
4. 4On Payment, review the final amount and optionally apply a promo code.
5. 5Connect a Solana wallet and approve the Circle USDC transaction when the final amount is above zero.
6. 6Wait for Medusa to verify the on-chain payment and activate the subscription.

Unique payment reference

Medusa creates a server-side payment intent with a unique payment reference and expiry. The Gateway verifies the payment against the expected subscription price and payment context before activation.

Promo codes

Promo validation can change the final amount before the payment intent is prepared. A code can be restricted by package, billing period, expiry, global usage and per-user usage.

100% promo

When an authorized 100% percentage promo produces a zero final amount, the checkout uses the promo reservation and signed order reference to activate the subscription without an on-chain USDC transfer.

Do not pay twice

After a Solana transaction has been confirmed, an activation retry must reuse the confirmed payment instead of sending another transfer. Medusa exposes a retry activation state for that purpose.