Gemeinsam genutzte ZahlungstokenPrivate Vorschau

Gemeinsame Zahlungstoken (Shared Payment Tokens, SPT) unterstützen Ihr Unternehmen dabei, die von einem Agenten erfasste Zahlungsmethode einer Kundin oder eines Kunden zu erhalten. Der Agent gewährt Ihrem Unternehmen SPTs mit Nutzungs- und Gültigkeitsbeschränkungen.

Gemeinsam genutztes Zahlungstoken erstellen

Als Verkäufer/in können Sie Testhelfer verwenden, um den Empfang einer von einem Agenten gewährten SPT zu simulieren. Dadurch wird ein SharedPaymentToken-Objekt gewährt. Das folgende Codebeispiel zeigt, wie Sie Ihrem Konto ein SPT mit einer Test-PaymentMethod gewähren und Grenzwerte simulieren, die Agenten angeben können, wie Währung, Höchstbetrag und Gültigkeitsdauer.

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

Nutzungsbeschränkungen

Der Parameter usage_limits gibt den Höchstbetrag und das Zeitfenster zum Ablauf an. Der Agent stellt dann den Höchstbetrag so ein, dass er dem Gesamtbetrag der Transaktion entspricht.

Angaben zum Verkäufer/zur Verkäuferin

Verwenden Sie den Parameter seller_details, um den SPT auf Sie oder eine/n andere/n Verkäufer/in zu beschränken.

• network_id: Die Netzwerk-ID des Verkäufers/der Verkäuferin.
• external_id: Eine optionale Kennung, die Sie angeben können, um den SPT mit einem bestimmten Verkäufer/in, Warenkorb oder einer anderen Kennung zu verknüpfen. Eine Connect-Plattform kann beispielsweise die external_id verwenden, um den SPT einem verbundenen Konto zuzuordnen.

Zahlungsmethode

Der Parameter payment_method gibt die von der Kundin/dem Kunden für den Kauf ausgewählte Zahlungsmethode an.

Gemeinsames Zahlungstoken verwenden

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

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

Wenn Sie einen PaymentIntent mit einem SPT bestätigen, legen wir 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 deren Nutzungslimits.

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

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.