# Appels à l'API pour les comptes connectés

Découvrez comment ajouter les informations appropriées pour vos appels à l'API afin de pouvoir effectuer des appels pour vos comptes connectés.

Vous pouvez lancer des appels à l’API pour les comptes connectés :

- Côté serveur avec l’[en-tête Stripe-Account](https://docs.stripe.com/connect/authentication.md#stripe-account-header) et l’ID du compte connecté, par requête
- Côté client, en transmettant l’ID du compte connecté comme argument à la bibliothèque client

Pour optimiser les performances et la fiabilité, Stripe a établi des [limites de débit et des affectations](https://docs.stripe.com/rate-limits.md) pour les endpoints d’API.

## Ajouter l’en-tête Stripe-Account côté serveur

Pour effectuer des appels à l’API côté serveur pour les comptes connectés, utilisez l’en-tête `Stripe-Account` avec l’identifiant du compte, qui commence par le préfixe `acct_`. Voici quatre exemples utilisant la [clé secrète API](https://docs.stripe.com/keys.md) de votre plateforme et l’identifiant de [compte](https://docs.stripe.com/api/accounts.md) de votre compte connecté :

#### Créer un PaymentIntent

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

#### Récupérer le solde

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

#### Lister les produits

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

#### Supprimer le client

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

L’approche d’en-tête `Stripe-Account` est implicite dans toute requête API qui inclut l’ID du compte Stripe dans l’URL. Voici un exemple qui montre comment [récupérer un compte](https://docs.stripe.com/api/accounts/retrieve.md) avec l’identifiant du [compte](https://docs.stripe.com/api/accounts.md) de votre utilisateur dans l’URL.

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

Toutes les bibliothèques de Stripe côté serveur prennent en charge l’approche suivante pour chaque requête&nbsp;:

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

## Ajouter l’ID du compte connecté à une application côté client

Les bibliothèques côté client configurent l’ID du compte connecté comme argument de l’application client&nbsp;:

#### HTML + JS

Le code JavaScript pour passer l’identifiant du compte connecté côté client est le même pour le JS ordinaire et pour ESNext.

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

## Utilisez les composants intégrés de Connect

Au lieu d’intégrer directement les API de Stripe, vous pouvez utiliser des [composants intégrés Connect](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) pour fournir les fonctionnalités Stripe à vos comptes connectés dans l’interface utilisateur de votre plateforme. Ces composants nécessitent moins de code pour implémenter et gérer tous les appels à l’API en interne.

Par exemple, pour afficher les données de paiement à vos comptes connectés, intégrez le [composant Payments](https://docs.stripe.com/connect/supported-embedded-components/payments.md) dans l’interface utilisateur de votre plateforme. Cela élimine la nécessité d’effectuer des appels distincts à l’API [Charges](https://docs.stripe.com/api/charges.md), [Payment Intents](https://docs.stripe.com/api/payment_intents.md), [Refunds](https://docs.stripe.com/api/refunds.md) et [Disputes](https://docs.stripe.com/api/disputes.md).

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.

Pour obtenir la liste complète des composants intégrés disponibles, consultez la page [Composants pris en charge](https://docs.stripe.com/connect/supported-embedded-components.md).

## See also

- [Création de paiements](https://docs.stripe.com/connect/charges.md)
- [Utiliser des abonnements](https://docs.stripe.com/connect/subscriptions.md)
- [Démarrer avec les composants intégrés de Connect](https://docs.stripe.com/connect/get-started-connect-embedded-components.md)