Administra el calendario de transferencias

Gestiona el calendario de transferencias automáticas a tus cuentas conectadas.

Nota

Usa la API Balance Settings para gestionar la configuración de transferencias tanto en cuentas v1 como en cuentas v2. El objeto Balance Settings sigue una estructura y comportamiento similares al hash settings.payouts de cuentas v1. Si tu cuenta v1 está usando actualmente settings.payouts, no es necesario migrar.

Cuando se usan transferencias automáticas, el hash payments.payouts.schedule contiene información sobre cuándo los fondos de una cuenta de Stripe están disponibles y cuándo se paga automáticamente el saldo.

propiedad delay_days

La propiedad settlement_timing.delay_days refleja cuánto tarda en estar disponible para pago los on_behalf_of (o los cargos directos realizados en la cuenta conectada). Puedes editar esta propiedad en cuentas en las que asumes responsabilidad por fraude y disputas.{ Esta propiedad se puede sobrescribir estableciendo delay_days_override en un número de hasta 31. Si se pasa una cadena vacía a delay_days_override, delay_days volverá al valor predeterminado, que es el valor más bajo disponible para la cuenta.

Este campo es útil para configurar transferencias automáticas. Stripe calcula el retraso en días hábiles o días naturales, según el país de la cuenta conectada. Por ejemplo, si quieres que una cuenta conectada en Singapur (que utiliza retrasos en días naturales) reciba sus fondos dos semanas después de realizarse el cargo, establece el campo interval en daily ydelay_days_override en 14.

Para las cuentas en las que Stripe gestiona la responsabilidad por fraude y disputas (por ejemplo, las cuentas Standard), el valor predeterminado es el valor más bajo permitido para la cuenta, determinado por el país de la cuenta conectada. En el caso de las cuentas en las que eres responsable de fraude y disputas, el valor se mantiene a la velocidad de transferencia original de forma predeterminada.

Propiedad de intervalo

Las plataformas que gestionan la responsabilidad por fraude y disputas, o que tienen controles de la plataforma, pueden ajustar el intervalo de transferencia. Hay cuatro configuraciones posibles para la propiedad interval:

La configuración manual evita que se hagan transferencias automáticas. Tendrás que transferir el saldo de la cuenta manualmente usando la API Payouts (que actúa como la cuenta conectada). También puedes establecer una cuenta en manual para usar Instant Payouts.
La configuración daily: establece que los cargos se paguen automáticamente delay_days días después de ser creados. El valor de delay_days no puede ser inferior al calendario de transferencias propio ni al calendario de transferencias predeterminado de la cuenta.
La configuración weekly: paga automáticamente el saldo al menos una vez por semana, en los días especificados por el weekly_payout_days (una lista de días de la semana).
La configuración monthly: paga automáticamente el saldo al menos una vez al mes, según lo especificado por el parámetro monthly_payout_days (una lista de números del 1 al 31). Las transferencias programadas nominalmente entre el 29 y el 31 se envían, en cambio, el último día de los meses más cortos.