Adds Payment Records and Payment Attempt Records
What’s new
Adds PaymentRecords and PaymentAttemptRecords, which allow you to report payments processed outside of Stripe. They also enable features such as subscriptions and invoices to work with payments processed through third-party payment processors.
Impact
You can now use Payment Records to record payments processed through your own payment processor, enabling functionality such as the following:
- Use subscriptions and invoices with payments that are processed outside of Stripe .
- Record external payments in Stripe so you can include them in your accounting and reporting.
Changes
| Change | Resources | |
|---|---|---|
| Added | PaymentAttemptRecord PaymentRecord | |
| Endpoints | Change | Resources |
| list retrieve | Added | PaymentAttemptRecord |
| report_payment report_payment_attempt report_payment_attempt_canceled report_payment_attempt_failed report_payment_attempt_guaranteed report_payment_attempt_informational report_refund retrieve | Added | PaymentRecord |
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-10-29. clover
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
- In Workbench, perform the upgrade . You can roll back the version for 72 hours.
Learn more about Stripe API upgrades.