Accept stablecoin payments
Start accepting stablecoins by enabling the Crypto payment method.
You can accept stablecoin payments through Payment Links, Checkout, Elements, or the Payment Intents API. When paying with stablecoins such as the related setting, customers get redirected to crypto.stripe.com to connect their crypto wallet and complete the transaction. Funds settle in your Stripe balance in USD.
Before you begin
Regional considerations United States
Stablecoin payments are available to businesses in all US states, except New York.
To start accepting stablecoin payments:
- Make sure you’ve set up your Stripe account .
- Go to your Payment methods settings in the Dashboard and request the Stablecoins and Crypto payment method.
- Stripe reviews your access request and contacts you for more details if necessary. The payment method appears as Pending while we review your request.
- After we approve your request, the Stablecoins and Crypto payment method becomes active in the Dashboard.
Use with dynamic payment methods Recommended
If you use Stripe’s default dynamic payment methods with Payment Links, Hosted Checkout, Embedded Checkout Forms, or Elements, then you don’t need to make any further updates. Stripe automatically displays stablecoin payment options to eligible customers.
Use with a custom integration
If necessary, you can add the crypto payment method to your payment integration manually.
Checkout
Elements
Direct API
Mobile
When creating a new Checkout Session, you need to:
- Enable crypto in your Dashboard. Stripe automatically displays crypto to eligible customers using dynamic payment methods. If you currently specify
payment_method_types, see the migration guide. - Make sure all
line_itemsuseusd.
Command Line
Test your integration
Test your crypto payment integration by opening the payment redirect page using your test API keys. You can test a successful payment flow at no cost using testnet assets.
- In a sandbox , create a new transaction using your chosen integration method, and open its redirect URL.
- Connect your preferred wallet and payment network.
- Complete the payment, and validate that you’re redirected to the expected URL.
Test payments with testnet assets
Most cryptocurrencies offer testnet assets, or tokens that have no monetary value, that you can use to test blockchain transactions. Stripe recommends the MetaMask wallet, Polygon Amoy testnet, and Circle faucet for testing, but you can use your own preferred services.
Install a wallet
- Download the MetaMask extension for your web browser.
- Create a new wallet or import an existing one .
Enable a testnet
- In your MetaMask wallet, select Networks from the main menu.
- Click Add custom network .
- Enter the following details:
- Network name : Amoy
- Default RPC URL : https://rpc-amoy. polygon. technology/
- Chain ID : 80002
- Currency symbol : POL
- Block explorer URL : https://amoy. polygonscan. com/
- Click Save .
Import a token
- In your MetaMask wallet, under Tokens , select Amoy from the network dropdown.
- Click the overflow menu ( ), and select Import tokens .
- Click Select a network > Amoy .
- Under Token contract address , paste the Polygon Amoy testnet contract address:
0x41E94Eb019C0762f9Bfcf9Fb1E58725BfB0e7582The Token symbol field automatically updates with the related setting and the Decimals field with 6 . - Click Next .
- Verify that you’re importing the the related setting token, and then click Import .
Your MetaMask wallet now shows POL and the related setting in the tokens list.
When testing refunds, the token sent to your wallet might have a different contract than the one used for payment. We recommend reviewing the transaction_hash of your refund on block explorer, and adding that token’s contract to your wallet. For example, you might see a 0x58277ebcabbe2a6694fbca8daf9e23163dbacf3e token contract address for Sepolia ETH the related setting refunds.
Get testnet assets
Note
To use some testnet faucets, you might need to hold a small amount of mainnet tokens.
- Open faucet.circle.com
- Click the related setting .
- Under Network , select Polygon PoS Amoy .
- Under Send to , paste your wallet address.
- Click Send 20 the related setting .
In addition to the related setting for making payments, you need POL to pay transaction costs:
- Open faucet.polygon.technology .
- Under Select Chain & Token , select Polygon Amoy and POL .
- Under Verify your identity , click the third-party platform you want to authenticate with, and complete the login process.
- Under Enter Wallet Address , paste your wallet address.
- Click Claim .
Testnet transactions can take a few minutes to complete. Check your wallet to confirm that the the related setting and POL has transferred.
