Cómo interpretar los saldos de las cuentas Connect

Tanto la cuenta de tu plataforma como una cuenta conectada son cuentas de Stripe, cada una con su propio saldo de cuenta separado.

Todas las cuentas de Stripe pueden tener saldos en dos estados:

• pending, es decir que los fondos aún no están disponibles para ser transferidos
• available, es decir que los fondos están disponibles para ser transferidos

With non-Connect accounts, processing charges increases the Stripe account balance. The charged amount, less any Stripe fees, is initially reflected on the pending balance, and becomes available on a 2-day rolling basis. (This timing can vary by country and account.) Available funds can be paid out to a bank account or debit card. Payouts reduce the Stripe account balance accordingly.

Con Connect, la cuenta de tu plataforma y cada cuenta conectada tienen sus propios saldos pending y available. La distribución de fondos entre ellos depende del tipo de cargos que utilices.

Además, una cuenta de plataforma también puede tener un saldo connect_reserved, que se utiliza para cubrir los saldos negativos de las cuentas conectadas.

Verificar el saldo de la cuenta conectada

Para verificar el saldo de una cuenta conectada, realiza una llamada a la API de recuperación de saldo autenticada como la cuenta conectada. El objeto Balance devuelto refleja los saldos pending y available.

curl https://api.stripe.com/v1/balance \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
"

Cómo contabilizar saldos negativos

Algunas acciones, como los reembolsos y los contracargos, crean transacciones negativas en la cuenta de Stripe. Stripe las administra a fin de mantener el saldo positivo para las cuentas relacionadas:

• Si es posible, Stripe compensará automáticamente las transacciones negativas con pagos futuros.
• En primer lugar, Stripe asigna las transacciones negativas a la cuenta en la que se efectuó el cargo asociado. Por ejemplo, si se le cobra a una cuenta conectada, el rembolso o el contracargo viene de la cuenta conectada. Si se le cobra a tu plataforma, el rembolso o el contracargo viene de la cuenta de tu plataforma.

A pesar de estas medidas, si el saldo de una cuenta conectada se vuelve negativo, la responsabilidad final depende de la propiedad controller.losses.payments de la cuenta:

• stripe (incluidas las cuentas estándar): la cuenta conectada es responsable de cubrir sus propios saldos negativos de Stripe.
• application (incluidas las cuentas Express y Custom): la plataforma es responsable de cubrir los saldos negativos de Stripe de la cuenta conectada.

Si una cuenta conectada tiene saldo negativo, Stripe debita de su cuenta externa registrada hasta el número máximo de intentos permitidos. Si todos los intentos fallan, Stripe suspende los pagos y débitos desde la cuenta externa hasta que la cuenta externa registrada se actualice.

Mientras una cuenta tiene saldo negativo, no se pueden hacer transferencias a la tarjeta de débito o al banco de la cuenta en su nombre. Stripe retomará el envío de transferencias a la cuenta conectada cuando el saldo de Stripe de la cuenta vuelva a ser positivo.

Débito automático en cuentas conectadas

Si Stripe aún no ha intentado debitar un saldo negativo de la cuenta externa de una cuenta conectada, puedes establecer debit_negative_balances en true para permitir que Stripe lo haga automáticamente.

El débito automático para saldos negativos es compatible con bancos de los siguientes países:

• Australia
• Canadá
• Países del área (SEPA de Europa, incluido el Reino Unido)
• Nueva Zelanda
• Estados Unidos

Consulta las Preguntas frecuentes sobre el débito automático para obtener un desglose detallado de los países y tipos de cuentas que se admiten.

La activación de debit_negative_balances activa los débitos según sea necesario, incluso cuando la cuenta conectada está en pagos manuales. Para obtener más detalles, consulta Impacto de los contracargos y los saldos negativos.

Saldos de reserva de las cuentas conectadas

Para protegerte de los saldos available negativos de la cuenta conectada de los que es responsable tu plataforma, Stripe mantiene una reserva en el saldo available de la cuenta de tu plataforma. Según el país de la cuenta conectada, Stripe inicia un retiro bancario en la cuenta bancaria de la cuenta para cubrir el saldo negativo. Aunque el saldo available para la cuenta se reduce a cero apenas se registra el retiro, la reserva de la plataforma para esa cuenta se retiene durante 3 días hábiles adicionales. Verás esta reserva reflejada en el Dashboard y en los informes exportados (como transacción de reserva).

Existen tres tipos de actividades de saldo relacionadas con las reservas:

• Fondos reservados para cubrir el saldo negativo de una cuenta conectada. Si el saldo de una cuenta conectada pasa a ser negativo, Stripe reserva temporalmente una parte de tu saldo para garantizar que se cubran los fondos creando una transacción de saldo de tipo reserve_transaction.
• Funds released after a positive balance change on a connected account. When a connected account’s previously negative balance becomes less negative due to activity on that account (for example, through new charges), a corresponding portion of your platform’s reserve balance is released through a balance transaction with the type reserve_transaction.
• Fondos recaudados debido a un saldo negativo de larga data en una cuenta conectada. Cuando el saldo de una cuenta conectada es negativo durante 180 días, Stripe transfiere una parte de tu saldo para dejar en cero el saldo de la cuenta creando una transacción de saldo de tipo connect_collection_transfer.

Para ver las reservas actuales que se mantienen en tu cuenta, haz una llamada API para recuperar el saldo, pero para tu propia cuenta (es decir, no con autorización como otro usuario como se menciona arriba).

Para compensar el saldo negativo de una cuenta conectada y, así, eliminar la reserva de tu cuenta, haz un envío de fondos a la cuenta correspondiente. Si una cuenta conectada tiene un saldo negativo durante más de 180 días, Stripe transferirá automáticamente tus reservas a la cuenta conectada para dejar en cero el saldo. Las páginas e informes del Dashboard muestran estos envíos de fondos como envíos de fondos de cobro de Connect.

Retención de fondos

Si necesitas un control más pormenorizado de la programación de las transferencias a las cuentas conectadas en las que tu plataforma es responsable de los saldos negativos, puedes adoptar uno de los siguientes enfoques:

• Retener fondos en el saldo de la plataforma antes de transferirlos a un saldo de cuenta conectado
• Mantener los fondos en el saldo de una cuenta conectada antes de transferirlos a una cuenta externa

Les recomendamos a las plataformas retener fondos solo si tienen la clara intención de hacerlo y el compromiso de completar el pago si se produce algún evento o se cumple una condición previa. El típico caso de uso en el que se retienen fondos son las plataformas de servicios on-demand, en las que el marketplace suele esperar a que el servicio esté completo y confirmado para pagarle al proveedor del servicio (por ejemplo, alquiler de autos, servicios de entregas y de transporte compartido).

Las plataformas no deben retener fondos de manera arbitraria, sino que deben pagarles a las cuentas conectadas tan pronto como son identificadas. Por lo general, esto sucede cuando se efectúa el cargo. Si no sabes si debes retener fondos, consulta con tu asesor legal.

Por razones de cumplimiento normativo, solo podemos mantener los fondos en una reserva durante cierto tiempo según el país del comerciante, como se muestra a continuación: