# API-Aufrufe für verbundene Konten durchführen

Erfahren Sie, welche Informationen Sie in Ihren API-Aufrufen für verbundene Konten verwenden sollten.

API-Aufrufe für verbundene Konten können Sie wie folgt durchführen:

- Serverseitig mit dem [Header „Stripe-Account“](https://docs.stripe.com/connect/authentication.md#stripe-account-header) und der ID des verbundenen Kontos, pro Anfrage
- Auf Client-Seite durch Übergabe der verbundenen Konto-ID als Argument an die Client-Bibliothek

Um die Leistung und die Zuverlässigkeit zu unterstützen, hat Stripe [Ratenbegrenzungen und Zuweisungen](https://docs.stripe.com/rate-limits.md) für API-Endpoints festgelegt.

## Fügen Sie den Stripe-Konto-Header serverseitig hinzu

Um serverseitige API-Aufrufe für verbundene Konten durchzuführen, verwenden Sie den `Stripe-Account`-Header mit der Kontokennung, die mit dem Präfix `acct_` beginnt. Hier sind vier Beispiele für die Verwendung des [geheimen API-Schlüssels](https://docs.stripe.com/keys.md) Ihrer Plattform und der [Kontokennung](https://docs.stripe.com/api/accounts.md) des verbundenen Kontos:

#### PaymentIntent erstellen

```curl
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d amount=1000 \
  -d currency=usd
```

#### Saldo abrufen

```curl
curl https://api.stripe.com/v1/balance \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}"
```

#### Produkte auflisten

```curl
curl -G https://api.stripe.com/v1/products \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d limit=5
```

#### Kunde/Kundin löschen

```curl
curl -X DELETE https://api.stripe.com/v1/customers/{{CUSTOMER_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}"
```

Das `Stripe-Account`-Header-Verfahren wird in jeder API-Anfrage impliziert, die die Stripe-Konto-ID in der URL enthält. Das folgende Beispiel zeigt, wie Sie mit der [Konto](https://docs.stripe.com/api/accounts.md)-ID Ihres/Ihrer Nutzers/in in der URL ein [Konto abrufen](https://docs.stripe.com/api/accounts/retrieve.md).

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:"
```

Alle serverseitigen Bibliotheken von Stripe unterstützen diesen Ansatz auf Anfragebasis:

```curl
curl https://api.stripe.com/v1/customers \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  --data-urlencode "email=person@example.com"
```

## Hinzufügen der ID des verbundenen Kontos zu einer clientseitigen Anwendung

Clientseitige Bibliotheken legen die ID des verbundenen Kontos als Argument für die Client-Anwendung fest:

#### HTML + JS

Der JavaScript-Code zur clientseitigen Übergabe der ID eines verbundenen Kontos ist für Plain JS und ESNext gleich.

```javascript
var stripe = Stripe('<<YOUR_PUBLISHABLE_KEY>>', {
  stripeAccount: '{{CONNECTED_ACCOUNT_ID}}',
});
```

#### React

```javascript
import {loadStripe} from '@stripe/stripe-js';

// Make sure to call `loadStripe` outside of a component's render to avoid
// recreating the `Stripe` object on every render.
const stripePromise = loadStripe('<<YOUR_PUBLISHABLE_KEY>>', {
  stripeAccount: '{{CONNECTED_ACCOUNT_ID}}',
});
```

#### iOS

#### Swift

```swift
import UIKit
import StripePayments

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
        StripeAPI.defaultPublishableKey = "<<YOUR_PUBLISHABLE_KEY>>"
        STPAPIClient.shared.stripeAccount = "{{CONNECTED_ACCOUNT_ID}}"
        return true
    }
}
```

#### Android

#### Kotlin

```kotlin
import com.stripe.android.PaymentConfiguration

class MyActivity: Activity() {
    private lateinit var stripe: Stripe

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        stripe = Stripe(
            this,
            PaymentConfiguration.getInstance(this).publishableKey,
            "{{CONNECTED_ACCOUNT_ID}}"
        )
    }
}
```

#### React Native

```javascript
import {StripeProvider} from '@stripe/stripe-react-native';

function App() {
  return (
    <StripeProvider
      publishableKey="<<YOUR_PUBLISHABLE_KEY>>"
      stripeAccountId="{{CONNECTED_ACCOUNT_ID}}"
    >
      {/* Your app code here */}
    </StripeProvider>
  );
}
```

## Verwenden Sie die in Connect eingebetteten Komponenten

Anstatt sie direkt in die APIs von Stripe zu integrieren, können Sie [Eingebettete Komponenten verbinden](https://docs.stripe.com/verbinden/get-started-connect-embedded-components.md) verwenden, um Stripe-Funktionalität für Ihre verbundenen Konten auf der Nutzeroberfläche Ihrer Plattform bereitzustellen. Diese Komponenten benötigen weniger Code, um alle API-Aufrufe intern zu implementieren und zu verarbeiten.

Wenn Sie beispielsweise Zahlungsdaten für Ihre verbundenen Konten anzeigen möchten, betten Sie die [Payments-Komponente](https://docs.stripe.com/verbinden/supported-embedded-components/payments.md) in die Nutzeroberfläche Ihrer Plattform ein. Dadurch entfällt die Notwendigkeit, separate Aufrufe an die API [Abbuchungen](https://docs.stripe.com/api/charges.md), [Payment Intents (Zahlungsabsichten)](https://docs.stripe.com/api/payment_intents.md), [Rückerstattungen](https://docs.stripe.com/api/refunds.md) und [Anfechtungen](https://docs.stripe.com/api/disputes.md) zu tätigen.

Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production.

Eine vollständige Liste der verfügbaren eingebetteten Komponenten finden Sie unter [Unterstützte Komponenten](https://docs.stripe.com/connect/supported-embedded-components.md).

## See also

- [Zahlungen erstellen](https://docs.stripe.com/connect/charges.md)
- [Abonnements verwenden](https://docs.stripe.com/connect/subscriptions.md)
- [Erste Schritte mit eingebetteten Connect-Komponenten](https://docs.stripe.com/connect/get-started-connect-embedded-components.md)