Administra el calendario de transferencias

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

Cuando usas pagos automáticos, el hash de settings.payouts.schedule en una Cuenta contiene detalles sobre cuándo están disponibles los fondos de una cuenta de Stripe y cuándo se paga automáticamente el saldo:

{
  "id": "{{CONNECTED_ACCOUNT_ID}}"
,
  "object": "account",
  "settings": {
    "payouts": {
      "schedule": {
        "delay_days": 7,
        "interval": "daily"
      },
      ...
    },
    ...
  },
  ...
}

propiedad delay_days

La propiedad delay_days refleja cuánto tardan los cargos on_behalf_of (o cargos directos efectuados en la cuenta conectada) en estar disponibles para transferirlos. Puedes editar esta propiedad en cuentas donde tengas responsabilidad por disputas y fraudes.

Este campo es útil para generar transferencias automáticas. Stripe calcula el retraso en días hábiles o días calendario en función del país de las cuentas conectadas. Por ejemplo, si quieres que una cuenta conectada con sede en Singapur (que utiliza retrasos de días calendario) reciba sus fondos dos semanas después de que se realice el cobro, establece interval en daily y delay_days en 14. Al configurar o actualizar este campo, puedes pasar la cadena minimum para elegir el valor más bajo permitido.

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 por día establece que la transferencia de los cargos se hará automáticamente delay_days días después de que se creen. El valor de delay_days no puede ser inferior a tu calendario de transferencias ni al calendario de transferencias predeterminado para la cuenta.
La configuración por semana establece que la transferencia del saldo se hará automáticamente una vez por semana según el día especificado en el parámetro weekly_anchor (un día de la semana en minúscula como lunes).
La configuración por mes establece que la transferencia del saldo se hará automáticamente una vez por mes según lo especificado en el parámetro monthly_anchor (un número del 1 al 31). En cambio, las transferencias programadas entre el 29 y el 31 de cada mes se envían, en teoría, el último día de un mes más corto.