Docs

Log into read the version of docs relevant to your site.

Stablecoin via Stripe

This feature is a Private Beta Release. Contact Chargebee Support to enable Stablecoin via Stripe for your live and test sites.

Stablecoins are cryptocurrencies whose value is pegged to stable fiat currencies, such as USD or EUR.

Due to their price stability, Stablecoins are ideal for reducing the volatility of crypto-based transactions.

This stability makes stablecoins useful for:

  • Payments: Enable faster, low-cost cross-border transactions
  • Remittances: Lower costs for sending funds to others

Chargebee now supports Stablecoin payments through the Stripe payment gateway, enabling merchants to accept crypto-based payments (e.g., USDC, USDP, USDG) while continuing to operate fully in fiat currency (USD).

This integration enables customers to pay using crypto wallets, while merchants can continue to charge in USD and receive settlements in USD directly into their bank accounts. Chargebee & Stripe manage and abstract all crypto complexities to ensure a simple, compliant, and stable payment experience.

You can now accept Stablecoin payments through Stripe in Chargebee, and Stripe for:

  • Recurring payments
  • One-time payments

Key Capabilities

FeatureSupport
Recurring paymentsSupported
One-time paymentsNot supported
RefundsSupported
DunningSupported
Smart RoutingSupported
Chargeback riskLow
Checkout UIStripe-hosted UI for Stablecoin-enabled checkout

Integration Options

Integration MethodDescription
Chargebee Hosted PagesCustomers select “Stablecoin” and are redirected to Stripe’s checkout page. Stripe handles wallet connection and transaction signing.
Chargebee JSEnables front-end customization for checkout initiation.
Chargebee APIUse the Chargebee API to pass Stablecoin payment data and initiate payments programmatically.

Supported Stablecoins

StablecoinNetworkSettlement CurrencyRecurring Support
USDCEthereum, PolygonUSDYes
USDPEthereumUSDYes

All settlement occurs in USD. Merchants are never exposed to price volatility or custody risks.

Prerequisites

Before enabling Stablecoin Payments via Stripe in Chargebee, ensure the following:

  1. Your Stripe account is based in the United States, as Stablecoin payments via Stripe are available only to US businesses.
  2. Enable Stablecoins and Crypto (payment method) in your Stripe dashboard (or) contact Stripe Support to enable it.
  3. Your Chargebee site currency is USD. If you have multi-currency pricing enabled, ensure that you add USD as a currency on your Chargebee site.
  4. Ensure Stablecoin support is enabled in your Chargebee account. Contact Chargebee Support to enable it.
  5. The Stripe payment gateway and webhooks are properly configured in Chargebee.

Configuring Stablecoin Payments via Stripe in Chargebee

To enable and configure Stablecoin payments in Chargebee:

  1. Log in to your Chargebee Billing site.
  2. Go to Settings > Configure Chargebee > Payment Gateways.
  3. Select Stripe from the list of configured gateways.
  4. Under Supported Payment Methods, enable Stablecoin.
  5. Click Apply to save your changes.
  6. Test the setup in your Chargebee test site using Stripe's sandbox credentials.
  7. Once validated, deploy to the live site.

Configure Smart Routing

Once Stablecoin via Stripe is enabled, Smart Routing for USD is automatically updated. Verify this in your settings.

To manually configure:

  1. Go to Settings > Configure Chargebee > Payment Gateways.
  2. Click Manage rules under Smart Routing.
  3. Locate the Stablecoin payment method for USD.
  4. From the dropdown, select the Stripe gateway account with Stablecoin enabled.
  5. Click Save.

Recurring Payments

1. Checkout Process

  • The customer chooses to pay via Stablecoins in the Chargebee Checkout.
  • When they click the final pay button, the customer is redirected to Stripe’s page to set up a recurring payment using their crypto wallet.
  • Customers can pre-approve a wallet for subsequent charges. If they need help to pay via Stablecoin, Stripe’s crypto wallet support allows them to choose from:
    • Coinbase Wallet
    • Metamask
    • WalletConnect
  • Once they authorize the payment, they are redirected back to the Chargebee Checkout “thank you” page.

2. Dunning

  • Chargebee creates an invoice and triggers payment.
  • Stripe attempts to make the wallet a mandate to fetch the due amount in USD.
  • If the Stripe attempt fails and the mandate is also unsuccessful, Chargebee triggers the dunning email if dunning is configured.
  • If dunning is not configured and the system auto-collects fails with Stripe, neither Chargebee nor Stripe recovers the customer's wallet details.

Refunds

Refunds for stablecoin payments can be initiated through:

Stripe processes the refund in Stablecoins, returned directly to the customer's wallet used for the original transaction.

Frequently Asked Questions (FAQs):

  1. What is Stablecoin via Stripe in Chargebee?

    Stablecoin via Stripe allows Chargebee merchants to accept payments in supported stablecoins (USDC, USDP, USDG) while receiving settlements entirely in USD. Stripe handles the crypto wallet and blockchain interactions, while Chargebee manages the billing workflows.

  2. Which stablecoins and networks are supported?

    • USDC — Ethereum, Solana, Polygon
    • USDP — Ethereum
    • USDG — Ethereum
  3. Is this feature available to all merchants?

    No. Stablecoin payments via Stripe can only be enabled if the merchant’s Stripe account is US-based.

  4. Does the customer need a crypto wallet?

    Yes, a supported wallet (e.g., MetaMask, Coinbase Wallet) is required.

  5. Does Chargebee ever access customer wallet details?

    No. Wallet connection, authorization, and blockchain interaction are completely handled by Stripe.

  6. Are recurring payments supported?

    Yes. Stripe creates a mandate during the initial transaction, which is used for future renewals.

  7. What happens if the wallet has insufficient funds during renewal?

    The charge fails, and Chargebee triggers the dunning flow. Customers can retry once they top up their wallet or switch payment methods.

  8. Am I exposed to crypto price volatility?

    No. Stripe converts the stablecoin to USD at the moment of transaction, so you never hold or manage crypto assets.

  9. Do I need to manage or store crypto?

    No. Stripe handles all blockchain interactions; merchants never custody crypto.

  10. Can I issue stablecoins to customers?

    No. Chargebee and Stripe do not support issuing stablecoins. Merchants can only accept stablecoin payments; they cannot mint or distribute stablecoins through this integration. Refunds are the only scenario in which stablecoins are returned to the customer, and even that is handled entirely by Stripe.

  11. Why did my recurring charge fail?

    Most commonly due to an insufficient wallet balance. The dunning process will guide the customer to retry or update payment details.

  12. What is the transaction limit for payments via Stablecoins?

    Customer transaction limits are US$10,000 per transaction.

Was this article helpful?