Gerenciar o cronograma de repasses

Gerencie o cronograma automático de repasses para suas contas conectadas.

Observação

Use a API Balance Settings para gerenciar as configurações de repasse para as contas v1 e v2. O objeto Balance Settings segue uma estrutura e um comportamento semelhantes ao hash settings.payouts nas contas v1. Se sua conta v1 estiver usando atualmente settings.payouts, você não precisa migrar.

Ao usar pagamentos automáticos, o hash payments.payouts.schedule contém dados da conta Stripe sobre quando os fundos estão disponíveis e quando o saldo é automaticamente repassado:

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

Propriedade delay_days

A propriedade settlement_timing.delay_days reflete o tempo que leva para que on_behalf_of cobranças (ou Direct Charges realizadas na conta conectada) fiquem disponíveis para repasses. Você pode editar essa propriedade nas contas em que você é responsável porfraudes e contestações. Essa propriedade pode ser substituída pela configuração de delay_days_override para um número até 31. Ao passar uma string vazia para delay_days_override, você vai retornar delay_days para o padrão, que é o menor valor disponível para a conta.

Esse campo é útil para ditar os repasses automáticos. A Stripe calcula o atraso em dias úteis ou dias corridos, dependendo do país das contas conectadas. Por exemplo, se você quiser que uma conta conectada estabelecida em Cingapura (que usa atrasos de dias corridos) receba seus fundos duas semanas após a cobrança, defina ointervalo para daily e delay_days_override para 14.

Para contas onde a Stripe gerencia responsabilidade por fraude e contestações (por exemplo, contas Standard), o padrão é o menor valor permitido para a conta, determinado pelo país da conta conectada. Para contas nas quais você possui responsabilidade por fraude e contestações, o valor permanece em sua velocidade original de repasses por padrão.

Propriedade de intervalo

Plataformas que gerenciam responsabilidade por fraudes e contestações, ou que têm controles de plataforma, podem ajustar o intervalo de repasses. Há quatro configurações possíveis spara a propriedade interval:

manual: esta configuração evita repasses automáticos. Será preciso repassar manualmente o saldo da conta pela API Payouts (atuando como a conta conectada). Também é possível definir uma conta como manual para usar Instant Payouts.
daily: esta configuração repassa automaticamente as cobranças delay_days dias após a sua criação. O valor de delay_days não pode ser menor que o seu cronograma de repasses ou o cronograma de repasses padrão da conta.
weekly: essa configuração paga automaticamente o saldo pelo menos uma vez por semana, com o(s) dia(s) especificado(s) pelo parâmetro weekly_payout_days (uma matriz de dias da semana).
monthly: essa configuração paga automaticamente o saldo pelo menos uma vez por mês, conforme especificado pelo parâmetro monthly_payout_days (uma matriz de números entre 1-31). Os pagamentos nominalmente programados entre os dias 29 e 31 do mês são enviados no último dia de um mês mais curto.