# Adds Billing Evaluations for assessing non-payment abuse risk ## What’s new Adds the ability to [create](https://docs.stripe.com/api/radar/billing-evaluation/create.md?api-version=2026-09-30.preview) the new [Billing Evaluation](https://docs.stripe.com/api/radar/billing-evaluation/object.md?api-version=2026-09-30.preview) object for [Radar](https://docs.stripe.com/radar.md). A Billing Evaluation assesses the non-payment abuse risk of an upcoming charge before you attempt payment. You provide [customer_details](https://docs.stripe.com/api/radar/billing-evaluation/create.md?api-version=2026-09-30.preview#create_radar_billing_evaluation-customer_details) and [payment_details](https://docs.stripe.com/api/radar/billing-evaluation/create.md?api-version=2026-09-30.preview#create_radar_billing_evaluation-payment_details) for the anticipated charge, and the API returns a `non_payment_abuse` signal with a `risk_level` (one of `elevated`, `highest`, `low`, `normal`, `not_assessed`, or `unknown`) and an `evaluated_at` timestamp. The `client_device_metadata_details` parameter is optional because billing evaluations typically run server-side for future charges where a Radar session doesn’t exist. You can’t currently retrieve or list the evaluations. ## Impact If you use [Radar Pro](https://docs.stripe.com/radar/how-radar-works.md#compare-plans) with a usage-based or post-paid billing model, you can screen upcoming charges for non-payment abuse risk and take action, such as issuing an invoice early or limiting access, before extending service to a customer. ## Changes #### REST API | | Change | Resource | | --- | --- | --- | | | Added | [Radar.BillingEvaluation](/api/radar/billing-evaluation/object?api-version=2026-09-30.preview#radar_billing_evaluation_object) | | Endpoint | Change | Resource | | --- | --- | --- | | `create` | Added | [Radar.BillingEvaluation](/api/radar/billing-evaluation/object?api-version=2026-09-30.preview#radar_billing_evaluation_object) | #### Ruby | | Change | Resource | | --- | --- | --- | | | Added | [Radar::BillingEvaluation](/api/radar/billing-evaluation/object?api-version=2026-09-30.preview#radar_billing_evaluation_object) | | Method | Change | Resource | | --- | --- | --- | | `create` | Added | [Radar::BillingEvaluation](/api/radar/billing-evaluation/object?api-version=2026-09-30.preview#radar_billing_evaluation_object) | #### Python | | Change | Resource | | --- | --- | --- | | | Added | [radar.BillingEvaluation](/api/radar/billing-evaluation/object?api-version=2026-09-30.preview#radar_billing_evaluation_object) | | Method | Change | Resource | | --- | --- | --- | | `create` | Added | [radar.BillingEvaluation](/api/radar/billing-evaluation/object?api-version=2026-09-30.preview#radar_billing_evaluation_object) | #### PHP | | Change | Resource | | --- | --- | --- | | | Added | [Radar.BillingEvaluation](/api/radar/billing-evaluation/object?api-version=2026-09-30.preview#radar_billing_evaluation_object) | | Method | Change | Resource | | --- | --- | --- | | `create` | Added | [Radar.BillingEvaluation](/api/radar/billing-evaluation/object?api-version=2026-09-30.preview#radar_billing_evaluation_object) | #### Java | | Change | Resource | | --- | --- | --- | | | Added | [radar.BillingEvaluation](/api/radar/billing-evaluation/object?api-version=2026-09-30.preview#radar_billing_evaluation_object) | | Method | Change | Resource | | --- | --- | --- | | `create` | Added | [radar.BillingEvaluation](/api/radar/billing-evaluation/object?api-version=2026-09-30.preview#radar_billing_evaluation_object) | #### Node.js | | Change | Resource | | --- | --- | --- | | | Added | [Radar.BillingEvaluation](/api/radar/billing-evaluation/object?api-version=2026-09-30.preview#radar_billing_evaluation_object) | | Method | Change | Resource | | --- | --- | --- | | `create` | Added | [Radar.BillingEvaluation](/api/radar/billing-evaluation/object?api-version=2026-09-30.preview#radar_billing_evaluation_object) | #### Go | | Change | Resource | | --- | --- | --- | | | Added | [RadarBillingEvaluation](/api/radar/billing-evaluation/object?api-version=2026-09-30.preview#radar_billing_evaluation_object) | | Method | Change | Resource | | --- | --- | --- | | `New` | Added | [RadarBillingEvaluation](/api/radar/billing-evaluation/object?api-version=2026-09-30.preview#radar_billing_evaluation_object) | #### .NET | | Change | Resource | | --- | --- | --- | | | Added | [Radar.BillingEvaluation](/api/radar/billing-evaluation/object?api-version=2026-09-30.preview#radar_billing_evaluation_object) | | Method | Change | Resource | | --- | --- | --- | | `Create` | Added | [Radar.BillingEvaluation](/api/radar/billing-evaluation/object?api-version=2026-09-30.preview#radar_billing_evaluation_object) | ## Upgrade #### REST API 1. [View your current API version](https://docs.stripe.com/workbench/guides.md#view-api-versions) 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](https://docs.stripe.com/api-versions.md#how-versions-are-specified-in-requests) to include `Stripe-Version: 2026-09-30.preview` 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Ruby 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 2. Upgrade your Ruby SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Python 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 2. Upgrade your Python SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### PHP 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 2. Upgrade your PHP SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Java 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 2. Upgrade your Java SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Node.js 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 2. Upgrade your Node SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Go 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 2. Upgrade your Go SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### .NET 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 2. Upgrade your .NET SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).