Skip to content
Create account
 or
Sign in
The Stripe Docs logo
/
Create account
Sign in
Overview
Billing
OverviewAbout the Billing APIs
Subscriptions
Tax
Overview
Reporting
OverviewReports for multiple accounts
Data
Overview

Set up a subscription with stablecoin paymentsPrivate preview

Learn how to create and charge for a subscription with stablecoins.

Use this guide to set up a subscription that withdraws recurring stablecoin payments from a customer’s crypto wallet.

Create a product and price
Dashboard

Products represent the item or service you’re selling. Prices define how much and how frequently you charge for a product. This includes how much the product costs, what currency you accept, and whether it’s a one-time or recurring charge. If you only have a few products and prices, create and manage them in the Dashboard.

This guide uses a stock photo service as an example and charges customers a 15 USD monthly subscription. To model this:

  1. Go to the Products page and click Create product.
  2. Enter a Name for the product. You can optionally add a Description and upload an image of the product.
  3. Select a Product tax code. Learn more about product tax codes.
  4. Select Recurring. Then enter 15 for the price and select USD as the currency.
  5. Choose whether to Include tax in price. You can either use the default value from your tax settings or set the value manually. In this example, select Auto.
  6. Select Monthly for the Billing period.
  7. Click More pricing options. Then select Flat rate as the pricing model for this example. Learn more about flat rate and other pricing models.
  8. Add an internal Price description and Lookup key to organize, query, and update specific prices in the future.
  9. Click Next. Then click Add product.

After you create the product and the price, record the price ID so you can use it in subsequent steps. The pricing page displays the ID and it looks similar to this: price_G0FvDp6vZvdwRZ.

Create a Checkout Session
Server-side

Your customer must authorize you to use their crypto wallet for future payments through Stripe.

Add a checkout button to your website that calls a server-side endpoint to create a Checkout Session.

index.html
<html>
  <head>
    <title>Checkout</title>
  </head>
  <body>
    <form action="/create-checkout-session" method="POST">
      <button type="submit">Checkout</button>
    </form>
  </body>
</html>

Create a Checkout Session in subscription mode to collect the required information. After creating the Checkout Session, redirect your customer to the URL that the response returns.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel" \
  -d "line_items[0][price]"={{RECURRING_PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d "payment_method_types[0]"=crypto \
  -d mode=subscription

Confirm the payment is successful

When your customer completes a payment, Stripe redirects them to the URL that you specified in the success_url parameter. Typically, this is a page on your website that informs your customer that their payment was successful.

However, crypto is a delayed notification payment method, which means that funds aren’t immediately available. Because of this, delay order fulfillment until the funds are available. After the payment succeeds, the underlying PaymentIntent status changes from processing to succeeded.

A crypto payment typically takes a few minutes to make the funds available.

You can confirm the payment is successful in several ways:

Successful payments appear in the Dashboard’s list of payments. When you click a payment, it takes you to the payment details page. The Checkout summary section contains billing information and the list of items purchased, which you can use to manually fulfill the order.

Note

Stripe can help you keep up with incoming payments by sending you email notifications whenever a customer successfully completes one. Use the Dashboard to configure email notifications.

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.

  1. In a sandbox, create a new transaction using your chosen integration method, and open its redirect URL.
  2. Connect your preferred wallet and payment network.
  3. 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

  1. Download the MetaMask extension for your web browser.
  2. Create a new wallet or import an existing one.

Enable a testnet

  1. In your MetaMask wallet, select Networks from the main menu.
  2. Click Add custom network.
  3. Enter the following details:
    • Network name: Polygon Amoy
    • Default RPC URL: https://rpc-amoy.polygon.technology/
    • Chain ID: 80002
    • Currency symbol: POL
    • Block explorer URL: https://amoy.polygonscan.com/
  4. Click Save.

Import a token

  1. In your MetaMask wallet, under Tokens, select Polygon Amoy from the network dropdown.
  2. Click the overflow menu (), and select Import tokens.
  3. Click Select a network > Polygon Amoy.
  4. Under Token contract address, paste the Polygon Amoy testnet contract address:
    0x41E94Eb019C0762f9Bfcf9Fb1E58725BfB0e7582
    The Token symbol field automatically updates with USDC and the Decimals field with 6.
  5. Click Next.
  6. Verify that you’re importing the USDC token, and then click Import.

Your MetaMask wallet now shows Polygon Amoy and USDC in the tokens list.

Get testnet assets

  1. Open faucet.circle.com
  2. Click USDC.
  3. Under Network, select Polygon PoS Amoy.
  4. Under Send to, paste your wallet address.
  5. Click Send 10 USDC.

In addition to USDC for making payments, you need POL to pay transaction costs:

  1. Open faucet.polygon.technology.
  2. Under Select Chain & Token, select Polygon Amoy and POL.
  3. Under Verify your identity, click the third-party platform you want to authenticate with, and complete the login process.
  4. Under Enter Wallet Address, paste your wallet address.
  5. Click Claim.

Testnet transactions can take a few minutes to complete. Check your wallet to confirm that the USDC and POL has transferred.

More testnet faucets

Check these faucet services for more testing token options:

Was this page helpful?
YesNo
Related Guides
Accept stablecoin payments