# Tokens de paiement partagés

Apprenez à utiliser les tokens de paiement partagés.

Utilisez des tokens de paiement partagés (SPT) pour recevoir le moyen de paiement d’un client d’un agent. L’agent accorde des SPT à votre compte avec des limites d’utilisation et d’expiration.
Enregistrement et traitement des modes de paiement (See full diagram at https://docs.stripe.com/agentic-commerce/concepts/shared-payment-tokens)
## Créer un token de paiement partagé

En tant que marchand, utilisez des outils de test pour simuler la réception d’un SPT accordé par un agent. Cette requête renvoie un objet `SharedPaymentToken`. L’exemple suivant accorde un SPT à votre compte à l’aide d’un moyen de paiement test et simule les limites que les agents peuvent définir, telles que la devise, le montant maximal et la fenêtre d’expiration.

```curl
curl https://api.stripe.com/v1/test_helpers/shared_payment/granted_tokens \
  -u "<<YOUR_SECRET_KEY>>": \
  -d payment_method=pm_card_visa \
  -d "usage_limits[currency]"=usd \
  -d "usage_limits[max_amount]"=10000 \
  -d "usage_limits[expires_at]"=1777754666
```

### Définir des limites d’utilisation

Utilisez le paramètre `usage_limits` pour spécifier le montant maximum et la période d’expiration, puis définissez le montant maximum de manière à ce qu’il corresponde au montant total de la transaction.

### Spécifier le moyen de paiement

Utilisez le paramètre `payment_method` pour spécifier le moyen de paiement sélectionné par le client pour l’achat.

## Utiliser un token de paiement partagé

Après avoir reçu un `SharedPaymentToken` accordé, créez un `PaymentIntent` pour finaliser le paiement.

```bash
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount=10000 \
  -d currency=usd \
  -d payment_method_data[shared_payment_granted_token]=spt_123 \
  -d confirm=true
```

Lorsque vous confirmez un `PaymentIntent` avec un SPT, Stripe définit `payment_method` sur un nouveau `PaymentMethod` cloné à partir du moyen de paiement d’origine du client. Les événements ultérieurs, tels que les remboursements et le reporting, se comportent alors comme si vous aviez fourni le `PaymentMethod` directement. Vous pouvez récupérer les détails du `SharedPaymentToken` accordé, y compris des informations limitées sur le moyen de paiement sous-jacent (par exemple, la marque de la carte bancaire et les quatre derniers chiffres), ainsi que ses limites d’utilisation.

```bash
curl https://api.stripe.com/v1/shared_payment/granted_tokens/{id} \
  -u "<<YOUR_SECRET_KEY>>:"
```

```json
  {
  "id": "spt_1RgaZcFPC5QUO6ZCDVZuVA8q",
  "object": "shared_payment.granted_token",
  "created": 1751500820,
  "deactivated_at": null,
  "deactivated_reason": null,
  "usage_limits": {
    "currency": "usd",
    "expires_at": 1751587220,
    "max_amount": 1000
  }
}
```

### Écouter les événements de webhook

Nous vous envoyons des événements, à vous et à l’agent, lorsque&nbsp;:

- Vous utilisez un SPT accordé pour accepter un paiement.
- L’agent révoque un SPT accordé. Vous ne pouvez pas créer de paiement avec un SPT révoqué.

| Événement                                  | Description | Reçu par                                                   | Cas d’usage                                                                          |
| ------------------------------------------ | ----------- | ---------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| `shared_payment.granted_token.used`        | Vous        | Vous recevez cet événement lorsque le SPT a été utilisé.   | Écoutez cet événement pour confirmer que le SPT a été utilisé.                       |
| `shared_payment.granted_token.deactivated` | Vous        | Le SPT a été désactivé (révoqué ou expiré).                | Écoutez cet événement pour savoir quand un SPT ne peut plus être utilisé.            |
| `shared_payment.issued_token.used`         | Agent       | L’agent reçoit cet événement lorsque vous utilisez le SPT. | L’agent écoute cet événement afin d’informer le client que le paiement a été traité. |
| `shared_payment.issued_token.deactivated`  | Agent       | Le SPT a été désactivé (révoqué ou expiré).                | L’agent écoute cet événement afin de suivre le moment où un SPT cesse d’être valide. |