Set up a subscription with Cash App Pay

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. Navigate to the Add a product page.
2. Enter a Name for the product.
3. Enter 15 for the price.
4. Select USD as the currency.
5. Click Save 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 subscription that has a price and customer with status of incomplete by providing the payment_behavior parameter with a value of default_incomplete. Set the payment_settings.save_default_payment_method=on_subscription parameter to save a payment method when a subscription is activated.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer={{CUSTOMER_ID}} \
  -d payment_behavior=default_incomplete \
  -d "items[0][price]"={{PRICE_ID}} \
  -d "payment_settings[save_default_payment_method]"=on_subscription \
  -d "expand[0]"="latest_invoice.payments" \
  -d "expand[1]"="latest_invoice.confirmation_secret"

The response includes the subscription’s first Invoice. This contains the invoice’s payments, which includes a default PaymentIntent that Stripe generated for this invoice and the confirmation secret which you can use on the client side to securely complete the payment process instead of passing the entire PaymentIntent object. Return the latest_invoice.confirmation_secret.client_secret to the front end to complete payment.

Get the PaymentIntent ID that you must use to confirm a payment from latest_invoice.payments.

Confirm a payment with PaymentIntents using the PaymentIntent ID from the Subscriptions response.

Add the PaymentIntent ID to the URL path and set the value of the payment_method_types parameter to cashapp.

curl https://api.stripe.com/v1/payment_intents/:id/confirm \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "payment_method_data[type]"=cashapp \
  --data-urlencode return_url="https://www.stripe.com" \
  -d "mandate_data[customer_acceptance][type]"=online \
  -d "mandate_data[customer_acceptance][online][ip_address]"="127.0.0.0" \
  -d "mandate_data[customer_acceptance][online][user_agent]"=device \
  -d "mandate_data[customer_acceptance][accepted_at]"=1660000000

The PaymentIntent response includes the status requires_action, which means your users must perform another action to complete the PaymentIntent. Use the next_action.cashapp_handle_redirect_or_display_qr_code object from the PaymentIntent response to redirect your users to a Stripe hosted page that displays the QR code, or render the QR code directly. To authenticate users, follow the instructions for redirect and authenticate transactions. After they authenticate, the Cash App mobile application redirects users to the return_url on their mobile device, and the PaymentIntent moves to a succeeded state.

After a successful payment, the subscription becomes active and saves the payment method as the default payment method.