# Fazer chamadas de API para contas conectadas

Saiba como adicionar os dados corretos a chamadas de API para fazer chamadas para suas contas conectadas.

Você pode fazer chamadas de API para contas conectadas:

- No lado do servidor, com o [cabeçalho Stripe-Account](https://docs.stripe.com/connect/authentication.md#stripe-account-header) e o ID da conta conectada, por solicitação
- Do lado do cliente, passando o ID da conta conectada como um argumento para a biblioteca do cliente

Para ajudar no desempenho e na confiabilidade, a Stripe estabeleceu [limites de taxa e alocações](https://docs.stripe.com/rate-limits.md) para endpoints de API.

## Adicionar o cabeçalho Stripe-Account no lado do servidor

Para fazer chamadas de API no lado do servidor para contas conectadas, use o cabeçalho `Stripe-Account` com o identificador da conta, que começa com o prefixo `acct_`. Veja a seguir quatro exemplos usando a [chave secreta de API](https://docs.stripe.com/keys.md) da sua plataforma e o identificador da [Conta](https://docs.stripe.com/api/accounts.md) da conta conectada:

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

#### Recuperar saldo

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

#### Listar produtos

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

#### Excluir cliente

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

A abordagem do cabeçalho `Stripe-Account` está implícita em qualquer solicitação de API que inclua o ID da conta Stripe no URL. Veja um exemplo que mostra como [recuperar uma conta](https://docs.stripe.com/api/accounts/retrieve.md) com o identificador da [conta](https://docs.stripe.com/api/accounts.md) do usuário no URL.

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

Todas as bibliotecas no lado do servidor da Stripe aceitam essa abordagem por solicitação:

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

## Adicionar o ID da conta conectada a uma inscrição no lado do cliente

As bibliotecas no lado do cliente definem o ID da conta conectada como um argumento do aplicativo do cliente:

#### HTML + JS

O código JavaScript para passar o lado do cliente do ID da conta conectada é o mesmo para JS e para 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>
  );
}
```

## Use componentes integrados do Connect

Em vez de integrar diretamente com as APIs do Stripe, você pode usar [Componentes integrados do Connect](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) para fornecer funções do Stripe às suas contas conectadas na IU da sua plataforma. Esses componentes exigem menos código para implementar e lidar com todas as chamadas da API internamente.

Por exemplo, para exibir dados de pagamentos das suas contas conectadas, integre o [componente Pagamentos](https://docs.stripe.com/connect/supported-embedded-components/payments.md) na interface do usuário da sua plataforma. Isso elimina a necessidade de fazer chamadas separadas para as APIs [Cobranças](https://docs.stripe.com/api/charges.md), [PaymentIntents](https://docs.stripe.com/api/payment_intents.md), [Reembolsos](https://docs.stripe.com/api/refunds.md) e [Contestações](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.

Veja uma lista completa dos componentes integrados disponíveis em [Componentes aceitos](https://docs.stripe.com/connect/supported-embedded-components.md).

## See also

- [Criar cobranças](https://docs.stripe.com/connect/charges.md)
- [Usar assinaturas](https://docs.stripe.com/connect/subscriptions.md)
- [Introdução aos componentes integrados do Connect](https://docs.stripe.com/connect/get-started-connect-embedded-components.md)