Adds support to include the IOF tax in the amount for Pix payments
What’s new
Adds amount_includes_iof to payment_method_options for the Pix payment method.
Impact
You can now absorb the IOF tax or choose to pass on the tax to your customer. You can set the amount_includes_iof parameter to two values:
- always : If you set it to always , the amount specified in the PaymentIntent is inclusive of the IOF tax.
- never : If you set it to never , the amount specified in the PaymentIntent is exclusive of the IOF tax and the customer pays more than the business-specified amount.
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| amount_includes_iof | Added | Checkout. 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 |
Upgrade
- View your current API version in Workbench.
- 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: 2025-08-27. basil
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
Learn more about Stripe API upgrades.