Tokens de paiement partagésVersion bêta privée

Les tokens de paiement partagés (SPT) permettent à votre entreprise de recevoir le moyen de paiement d’un client collecté par un agent. L’agent accorde des tokens SPT à votre entreprise avec des limites d’utilisation et une date d’expiration.

Créer un token de paiement partagé

En tant que marchand, vous pouvez utiliser des outils de test pour simuler la réception d’un SPT accordé par un agent. Cela accorde un objet SharedPaymentToken. L’exemple de code suivant montre comment accorder un SPT à votre compte à l’aide d’un PaymentMethod de test et simuler les limites que les agents peuvent définir, telles que la devise, le montant maximal et la fenêtre d’expiration.

curl https://api.stripe.com/v1/test_helpers/shared_payment/granted_tokens \
  -u 
"sk_test_BQokikJOvBiI2HlWgH4olfQ2" \
  -d payment_method=pm_card_visa \
  -d "usage_limits[currency]"=usd \
  -d "usage_limits[max_amount]"=10000 \
  -d "usage_limits[expires_at]"={{TIME_IN_FUTURE}} \
  -d "seller_details[network_id]"=internal \
  -d "seller_details[external_id]"={{ANY_STRING}}

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.

Détails du marchand

Utilisez le paramètre seller_details pour attribuer le SPT à vous-même ou à un autre commerçant.

• network_id: l’ID du réseau du marchand.
• external_id: identifiant facultatif que vous pouvez spécifier pour associer le SPT à un commerçant, à un panier ou à un autre identifiant spécifique. Par exemple, une plateforme Connect peut utiliser l’external_id pour limiter le SPT à un compte connecté.

Moyen de paiement

Le paramètre payment_method indique 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.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=10000 \
  -d currency=usd \
  -d shared_payment_granted_token=spt_123 \
  -d confirm=true

Lorsque vous confirmez un PaymentIntent avec un SPT, nous définissons 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.

curl https://api.stripe.com/v1/shared_payment/granted_tokens/{id} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

{
  "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 :

• 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é.