# Ajoute les Registres de paiement et les Registres de tentatives de paiement

## Nouveautés

Ajoute [PaymentRecords](https://docs.stripe.com/api/payment-record.md?api-version=2025-10-29.clover) et [PaymentAttemptRecords](https://docs.stripe.com/api/payment-attempt-record.md?api-version=2025-10-29.clover), qui vous permettent de signaler les paiements traités en dehors de Stripe. Ils permettent également à des fonctionnalités telles que les [abonnements](https://docs.stripe.com/subscriptions.md) et les [factures](https://docs.stripe.com/invoicing.md) de fonctionner avec les paiements traités par des prestataire de services de paiement.

## Impact

Vous pouvez désormais utiliser les Registres de paiement pour enregistrer les paiements traités via votre propre prestataire de services de paiement, ce qui permet d’activer les fonctionnalités suivantes :

- Utilisez les abonnements et les factures [avec les paiements traités en dehors de Stripe](https://docs.stripe.com/billing/subscriptions/third-party-payment-processing.md).
- Enregistrez les paiements externes dans Stripe afin de pouvoir les inclure dans votre comptabilité et vos rapports.

## Modifications

#### API REST

|  | Change | Resources                                                                                                                                                           |
|  | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover), [PaymentRecord](/api/payment-record/object?api-version=2025-10-29.clover) |

| Endpoints                                                                                                                                                                                                                | Change | Resources                                                                                |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ | ---------------------------------------------------------------------------------------- |
| `list`, `retrieve`                                                                                                                                                                                                       | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover) |
| `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](/api/payment-record/object?api-version=2025-10-29.clover)                |

#### Ruby

|  | Change | Resources                                                                                                                                                           |
|  | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover), [PaymentRecord](/api/payment-record/object?api-version=2025-10-29.clover) |

| Methods                                                                                                                                                                                                                  | Change | Resources                                                                                |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ | ---------------------------------------------------------------------------------------- |
| `list`, `retrieve`                                                                                                                                                                                                       | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover) |
| `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](/api/payment-record/object?api-version=2025-10-29.clover)                |

#### Python

|  | Change | Resources                                                                                                                                                           |
|  | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover), [PaymentRecord](/api/payment-record/object?api-version=2025-10-29.clover) |

| Methods                                                                                                                                                                                                                  | Change | Resources                                                                                |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ | ---------------------------------------------------------------------------------------- |
| `list`, `retrieve`                                                                                                                                                                                                       | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover) |
| `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](/api/payment-record/object?api-version=2025-10-29.clover)                |

#### PHP

|  | Change | Resources                                                                                                                                                           |
|  | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover), [PaymentRecord](/api/payment-record/object?api-version=2025-10-29.clover) |

| Methods                                                                                                                                                                                                                  | Change | Resources                                                                                |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ | ---------------------------------------------------------------------------------------- |
| `all`, `retrieve`                                                                                                                                                                                                        | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover) |
| `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](/api/payment-record/object?api-version=2025-10-29.clover)                |

#### Java

|  | Change | Resources                                                                                                                                                           |
|  | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover), [PaymentRecord](/api/payment-record/object?api-version=2025-10-29.clover) |

| Methods                                                                                                                                                                                                                  | Change | Resources                                                                                |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ | ---------------------------------------------------------------------------------------- |
| `list`, `retrieve`                                                                                                                                                                                                       | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover) |
| `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](/api/payment-record/object?api-version=2025-10-29.clover)                |

#### Node.js

|  | Change | Resources                                                                                                                                                           |
|  | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover), [PaymentRecord](/api/payment-record/object?api-version=2025-10-29.clover) |

| Methods                                                                                                                                                                                                                  | Change | Resources                                                                                |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ | ---------------------------------------------------------------------------------------- |
| `list`, `retrieve`                                                                                                                                                                                                       | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover) |
| `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](/api/payment-record/object?api-version=2025-10-29.clover)                |

#### Go

|  | Change | Resources                                                                                                                                                           |
|  | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover), [PaymentRecord](/api/payment-record/object?api-version=2025-10-29.clover) |

| Methods                                                                                                                                                                                             | Change | Resources                                                                                |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------------------------------------------------------------- |
| `Get`, `List`                                                                                                                                                                                       | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover) |
| `Get`, `ReportPayment`, `ReportPaymentAttempt`, `ReportPaymentAttemptCanceled`, `ReportPaymentAttemptFailed`, `ReportPaymentAttemptGuaranteed`, `ReportPaymentAttemptInformational`, `ReportRefund` | Added  | [PaymentRecord](/api/payment-record/object?api-version=2025-10-29.clover)                |

#### .NET

|  | Change | Resources                                                                                                                                                           |
|  | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover), [PaymentRecord](/api/payment-record/object?api-version=2025-10-29.clover) |

| Methods                                                                                                                                                                                             | Change | Resources                                                                                |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------------------------------------------------------------- |
| `Get`, `List`                                                                                                                                                                                       | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover) |
| `Get`, `ReportPayment`, `ReportPaymentAttempt`, `ReportPaymentAttemptCanceled`, `ReportPaymentAttemptFailed`, `ReportPaymentAttemptGuaranteed`, `ReportPaymentAttemptInformational`, `ReportRefund` | Added  | [PaymentRecord](/api/payment-record/object?api-version=2025-10-29.clover)                |

## Mise à niveau

#### API REST

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Si vous utilisez un SDK, passez à une version correspondant à celle de l’API.
   - Si vous n’utilisez pas de SDK, mettez à jour vos [requêtes API](https://docs.stripe.com/api/versioning.md) pour inclure la `version Stripe : 2025-10-29.clover`
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### Ruby

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Mettez à niveau votre SDK Ruby vers [v17.1.0](https://github.com/stripe/stripe-ruby/releases/tag/v17.1.0)
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### Python

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Mettez à niveau votre SDK Python vers [v13.1.0](https://github.com/stripe/stripe-python/releases/tag/v13.1.0)
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### PHP

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Mettez à niveau votre SDK PHP vers [v18.1.0](https://github.com/stripe/stripe-php/releases/tag/v18.1.0)
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### Java

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Mettez à niveau votre SDK Java vers [v30.1.0](https://github.com/stripe/stripe-java/releases/tag/v30.1.0)
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### Node.js

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Mettez à niveau votre SDK Node vers [v19.2.0](https://github.com/stripe/stripe-node/releases/tag/v19.2.0)
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### Go

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Mettez à niveau votre SDK Go vers [v83.1.0](https://github.com/stripe/stripe-go/releases/tag/v83.1.0)
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### .NET

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Mettez à niveau votre SDK .NET vers [v49.1.0](https://github.com/stripe/stripe-dotnet/releases/tag/v49.1.0)
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).