# Cómo hacer llamadas de API para cuentas conectadas

Aprende a agregar la información correcta a tus llamadas de API para poder hacer llamadas para tus cuentas conectadas.

Puedes hacer llamadas de API para tus cuentas conectadas:

- Del lado del servidor con el [encabezado Stripe-Account](https://docs.stripe.com/connect/authentication.md#stripe-account-header) y el ID de la cuenta conectada, por solicitud
- Del lado del cliente pasando el ID de la cuenta conectada como argumento a la biblioteca del cliente

A fin de mejorar el rendimiento y la confiabilidad, Stripe estableció [límites de frecuencia y asignaciones](https://docs.stripe.com/rate-limits.md) para los puntos de conexión de la API.

## Cómo agregar el encabezado de la cuenta de Stripe del lado del servidor

Para realizar llamadas API del lado del servidor para cuentas conectadas, usa el `Stripe-Account` con el identificador de cuenta, que comienza con el prefijo `acct_`. Aquí tienes cuatro ejemplos con la [clave secreta de la API](https://docs.stripe.com/keys.md) de tu plataforma y el identificador de [Cuenta](https://docs.stripe.com/api/accounts.md) de la cuenta conectada:

#### Çřèáƭè Þá¥₥èñƭÌñƭèñƭ

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

#### Lista de productos

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

#### Eliminar cliente

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

El método del encabezado `Stripe-Account` está implícito en las solicitudes de la API que incluyan la ID de la cuenta de Stripe en la URL. Este es un ejemplo que muestra cómo [Recuperar una cuenta](https://docs.stripe.com/api/accounts/retrieve.md) con el identificador de [Account](https://docs.stripe.com/api/accounts.md) de tu usuario en la URL.

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

Todas las bibliotecas del lado del servidor de Stripe admiten este enfoque por solicitud:

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

## Agregar la ID de la cuenta conectada a una solicitud del lado del cliente

Las bibliotecas del lado del cliente establecen el ID de la cuenta conectada como argumento en la aplicación del cliente:

#### HTML + JS

El código de JavaScript para especificar el ID de la cuenta conectada del lado del cliente es el mismo para JS y para ESNext.

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

#### Reaccionar

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

## Usa componentes integrados de Connect

En lugar de integrarte directamente con las API de Stripe, puedes usar los [componentes integrados de Connect](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) para proporcionar funcionalidades de Stripe a tus cuentas conectadas en la interfaz de usuario (IU) de tu plataforma. Estos componentes requieren menos código para implementar y manejar todas las llamadas API internamente.

Por ejemplo, para mostrar los datos de pago a tus cuentas conectadas, integra el [componente Payments](https://docs.stripe.com/connect/supported-embedded-components/payments.md) en la interfaz de usuario (IU) de tu plataforma y eliminar la necesidad de realizar llamadas separadas a la API de [cobro](https://docs.stripe.com/api/charges.md), [Payment Intents](https://docs.stripe.com/api/payment_intents.md), [reembolsos](https://docs.stripe.com/api/refunds.md), y [disputas](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.

Para obtener una lista completa de los componentes integrados disponibles, consulta [componentes soportados](https://docs.stripe.com/connect/supported-embedded-components.md).

## See also

- [Creación de cargos](https://docs.stripe.com/connect/charges.md)
- [Uso de suscripciones](https://docs.stripe.com/connect/subscriptions.md)
- [Componentes integrados de Primeros pasos con Connect](https://docs.stripe.com/connect/get-started-connect-embedded-components.md)