Stripe | Financial Infrastructure to Grow Your Revenue

Stripe | Financial Infrastructure to Grow Your Revenue

4466 articles

Adds support for Pix recurring payments

Adds support for Pix recurring payments

What’s new

Adds support for Pix recurring payments. You can now use Pix to collect recurring payments from customers by creating subscriptions with mandate options that specify the terms for future payments.

When you create a Payment Intent, Setup Intent, or Checkout Session with Pix, you can configure mandate options including:

  • amount : The amount to charge for future payments
  • amount_type : Whether the amount is fixed or represents a maximum
  • currency : Three-letter ISO currency code
  • payment_schedule : Schedule for recurring payments (monthly, quarterly, etc.)
  • reference : Subscription name displayed to customers
  • start_date and end_date : Mandate validity period

You can also set setup_future_usage to off_session when creating Payment Intents with Pix to enable recurring payments. Setup Intents with Pix support QR code display for customer authentication.

Impact

You can now create subscriptions that use Pix as the payment method for recurring billing for customers in Brazil. If you’re already using Pix for one-time payments, update your integration to support recurring payments by adding mandate options when creating Payment Intents, Setup Intents, or Checkout Sessions with Pix.

Changes

ParametersChangeResources or endpoints
mandateAddedCharge. payment_method_details. pix PaymentAttemptRecord. payment_method_details. pix PaymentRecord. payment_method_details. pix
mandate_optionsAddedCheckout. Session#create. payment_method_options. pix Checkout. Session. payment_method_options. pix PaymentIntent#confirm. payment_method_options. pix + 3 more PaymentIntent#create. payment_method_options. pix PaymentIntent#update. payment_method_options. pix PaymentIntent. payment_method_options. pix
pixAddedInvoice#create. payment_settings. payment_method_options Invoice#update. payment_settings. payment_method_options Invoice. payment_settings. payment_method_options + 9 more Mandate. payment_method_details SetupAttempt. payment_method_details SetupIntent#confirm. payment_method_options SetupIntent#create. payment_method_options SetupIntent#update. payment_method_options SetupIntent. payment_method_options Subscription#create. payment_settings. payment_method_options Subscription#update. payment_settings. payment_method_options Subscription. payment_settings. payment_method_options
amount currencyAddedMandate. multi_use
pix_display_qr_codeAddedSetupIntent. next_action
ValueChangeEnums
pixAddedInvoice#update. payment_settings Invoice#create. payment_settings Invoice. payment_settings + 3 more Subscription#update. payment_settings Subscription#create. payment_settings Subscription. payment_settings
FieldsChangeFrom → to
Checkout. Session#create. payment_method_options. pix. setup_future_usage Checkout. Session. payment_method_options. pix. setup_future_usage PaymentIntent#confirm. payment_method_options. pix. setup_future_usage PaymentIntent#create. payment_method_options. pix. setup_future_usage PaymentIntent#update. payment_method_options. pix. setup_future_usage PaymentIntent. payment_method_options. pix. setup_future_usageChangedliteral('none') → enum('none'|'off_session')

Upgrade

  1. View your current API version in Workbench.
  2. If you use an SDK, upgrade to the corresponding SDK version for this API version.
  • If you don’t use an SDK, update your API requests to include Stripe-Version: 2026-04-22. dahlia
  1. Upgrade the API version used for webhook endpoints .
  2. Test your integration against the new version.
  3. If you use Connect, test your Connect integration .
  4. In Workbench, perform the upgrade . You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.

Last verified 2026-09-24
Adds balance report and payout reconciliation report embedded components to the Account Session APIAdds the moto property to Setup Attempt payment method details for cards

Is this helpful?