Administra el calendario de transferencias

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

Nota

This guide shows how to configure payouts using the Balance Settings API. Use Balance Settings to manage payout settings for Accounts v2. The Balance Settings object follows similar structure and behavior to the Accounts v1 settings.payouts hash. If you’re currently using settings.payouts on Accounts v1, you can continue to do so.

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.

{
  "object": "balance_settings",
  "payments": {
    "debit_negative_balances": true,
    "payouts": {
      "minimum_balance_by_currency": {
        "usd": 1500,
        "cad": 8000
      },
      "schedule": {
        "interval": "weekly",
        "weekly_payout_days": ["monday", "wednesday"],
        "monthly_payout_days": null
      },
      "statement_descriptor": null,
      "status": "enabled"
    },
    "settlement_timing": {
      "delay_days_override": 3,
      "delay_days": 3
    }
  }
}

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.