Konten mit Kundenkonfiguration verwenden

Mit Accounts v2 können Sie ein Kontoobjekt ähnlich wie ein Kundenobjekt verwenden, indem Sie ihm die Kundenkonfiguration zuweisen.

curl -X POST https://api.stripe.com/v2/core/accounts \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2025-11-17.preview" \
  --json '{
    "contact_email": "jenny.rosen@example.com",
    "display_name": "Jenny Rosen",
    "identity": {
        "country": "us",
        "individual": {
            "given_name": "Jenny Rosen"
        }
    },
    "configuration": {
        "customer": {
            "capabilities": {
                "automatic_indirect_tax": {
                    "requested": true
                }
            }
        }
    },
    "include": [
        "configuration.customer",
        "identity"
    ]
  }'

Wenn Sie Accounts v2 verwenden, erstellen Ihre von Stripe gehosteten Integrationen, wie Checkout, Konten mit der customer-Konfiguration. Wenn Ihr Code auf Kundinnen/Kunden verweist, empfehlen wir, ihn stattdessen auf kundenkonfigurierte Konten umzustellen.

Ein Konto als Kundin oder Kunde angeben

API-Anfragen wie Subscriptions und SetupIntents erfordern die Angabe einer Kundin/eines Kunden. Diese Anfragen akzeptieren entweder den Parameter customer oder customer_account. Das folgende Beispiel zeigt ein Abo, das die Kundin/den Kunden angibt, indem es ein Accounts v2-Objekt als customer_account übergibt.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-04-30.preview" \
  -d customer_account=acct_xxxxx \
  -d "items[0][price]"=price_CBb6IXqvTLXp3f \
  -d "items[0][quantity]"=5

Referenzkonten in Customers v1-Integrationen

Eine Anfrage, die customer_account angibt, gibt sowohl die Eigenschaften customer als auch customer_account mit entsprechend formatierten Werten zurück. Dadurch wird die Kompatibilität mit bestehenden Billing- und Payments-Integrationen gewahrt.

{
  "id": "sub_1Mow234",
  .
  .
  .
  "customer": "cus_xxxxx",
  "customer_account": "acct_xxxxx"
}

Sie können von Kundinnen/Kunden konfigurierte Konten auch über den Endpoint /v1/customers abrufen oder aktualisieren.

curl -X POST https://api.stripe.com/v1/customers/acct_1234 \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Accounts v2-Webhooks

Webhooks für Accounts v2 senden Thin Events.

Eigenschaften der Kundenrechnungen

Eine Accounts-v2-ID in einem /v1/customers-Pfadparameter referenzieren

Accounts v2 verfügt nicht über Endpoints für alle Kundenfunktionen. Um die folgenden Aktionen für ein Accounts-v2-Objekt auszuführen, verwenden Sie den Endpunkt /v1/customers und übergeben Sie die Account-ID (acct_xxxxx) als Pfadparameter.