# Gemeinsam genutzte Zahlungstoken

Erfahren Sie, wie Sie gemeinsam genutzte Zahlungstoken verwenden.

Verwenden Sie gemeinsame Zahlungstoken (Shared Payment Tokens, SPT), um die Zahlungsmethode einer Kundin oder eines Kunden von einem Agenten zu erhalten. Der Agent gewährt Ihrem Konto SPTs mit Nutzungs- und Gültigkeitsbeschränkungen.
Registrierung und Verarbeitung von Zahlungsmethoden (See full diagram at https://docs.stripe.com/agentic-commerce/concepts/shared-payment-tokens)
## Gemeinsam genutztes Zahlungstoken erstellen

Als Verkäufer/in können Sie Testhelfer/innen verwenden, um den Empfang einer von einem Agenten gewährten SPT zu simulieren. Diese Anfrage gibt ein `SharedPaymentToken`-Objekt zurück. Das folgende Beispiel gewährt Ihrem Konto ein SPT mit einer Testzahlungsmethode und simuliert Beschränkungen, die Agenten angeben können, wie Währung, Höchstbetrag und Gültigkeitsdauer.

```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
```

### Legen Sie Nutzungsbeschränkungen fest

Verwenden Sie den Parameter `usage_limits`, um den Höchstbetrag und das Zeitfenster festzulegen. Der Agent stellt den Höchstbetrag so ein, dass er dem Gesamtbetrag der Transaktion entspricht.

### Geben Sie die Zahlungsmethode an

Verwenden Sie den Parameter `payment_method`, um die Zahlungsmethode anzugeben, die die Kundin oder der Kunde für den Kauf ausgewählt hat.

## Gemeinsames Zahlungstoken verwenden

Nachdem Sie ein gewährtes `SharedPaymentToken` erhalten haben, erstellen Sie einen `PaymentIntent`, um die Zahlung abzuschließen.

```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
```

Wenn Sie einen `PaymentIntent` mit einem SPT bestätigen, legt Stripe `payment_method` auf eine neue `PaymentMethod` fest, die aus der ursprünglichen Methode der Kundin oder des Kunden geklont wurde. Nachfolgende Ereignisse, wie Rückerstattungen und Berichte, verhalten sich so, als hätten Sie die `PaymentMethod` direkt angegeben. Sie können Details zum gewährten `SharedPaymentToken` abrufen, einschließlich begrenzter Informationen über die zugrunde liegende Zahlungsmethode (zum Beispiel Marke der Karte und die letzten vier Ziffern) und seiner Nutzungsbeschränkungen.

```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
  }
}
```

### Webhook-Ereignisse überwachen

Wir senden in folgenden Situationen Ereignisse an Sie und den Agenten:

- Sie verwenden einen gewährten SPT, um eine Zahlung zu akzeptieren.
- Der Agent widerruft einen gewährten SPT. Sie können keine Zahlung mit einem widerrufenen SPT erstellen.

| Ereignis                                   | Beschreibung | Empfangen von                                                   | Anwendungsbereich                                                                                                              |
| ------------------------------------------ | ------------ | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `shared_payment.granted_token.used`        | Sie          | Sie erhalten dieses Ereignis, wenn der SPT verwendet wurde.     | Überwachen Sie dieses Ereignis, um zu bestätigen, dass der SPT verwendet wurde.                                                |
| `shared_payment.granted_token.deactivated` | Sie          | Der SPT wurde deaktiviert (widerrufen oder abgelaufen).         | Überwachen Sie dieses Ereignis, um zu erfahren, wann ein SPT nicht mehr verwendet werden kann.                                 |
| `shared_payment.issued_token.used`         | Agent        | Der Agent empfängt dieses Ereignis, wenn Sie den SPT verwenden. | Der Agent überwacht dieses Ereignis, um die Kundin oder den Kunden darüber zu informieren, dass die Zahlung verarbeitet wurde. |
| `shared_payment.issued_token.deactivated`  | Agent        | Der SPT wurde deaktiviert (widerrufen oder abgelaufen).         | Der Agent überwacht dieses Ereignis, um nachzuverfolgen, wann ein SPT nicht mehr gültig ist.                                   |