Gérer la fréquence des virements

Gérez la fréquence des virements automatiques pour vos comptes connectés.

Remarque

Utilisez l’API Balance Settings pour gérer les paramètres de paiement pour les comptes v1 et v2. L’objet Balance Settings suit une structure et un comportement similaires à ceux du hachage settings.payouts dans les comptes v1. Si votre compte v1 utilise actuellement le paramètre settings.payouts, vous n’avez pas besoin de migrer.

Lorsque vous utilisez les virements automatiques, le hachage du paramètre payments.payouts.schedule contient des informations détaillées sur la date à laquelle les fonds d’un compte Stripe sont disponibles et à laquelle le solde est automatiquement viré :

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

Propriété delay_days

La propriété settlement_timing.delay_days indique le délai nécessaire pour que les frais on_behalf_of (ou les paiements directs effectués sur le compte connecté) soient disponibles pour le paiement. Vous pouvez modifier cette propriété sur les comptes pour lesquels vous êtes responsable en cas de fraude ou de litige. Cette propriété peut être remplacée en configurant le paramètredelay_days_override sur un nombre allant jusqu’à 31. Si vous passez une chaîne de caractères vide à delay_days_override, le paramètre delay_days reviendra à sa valeur par défaut, qui est la valeur la plus basse disponible pour le compte.

Ce champ est utile pour déterminer les virements automatiques. Stripe calcule le délai en jours ouvrables ou en jours civils, selon le pays des comptes connectés. Par exemple, si vous souhaitez qu’un compte connecté basé à Singapour (qui utilise des délais en jours civils) reçoive ses fonds deux semaines après la facturation, fixez l’intervalle sur quotidien et le paramètre delay_days_override sur 14.

Pour les comptes pour lesquels Stripe gère la responsabilité en matière de fraude et de litige (par exemple, les comptes Standard), la valeur par défaut est la valeur la plus basse autorisée pour le compte, déterminée par le pays du compte connecté. Pour les comptes pour lesquels vous êtes responsable de la fraude et des litiges, la valeur reste par défaut à votre vitesse de virement initiale.

Propriété interval

Les plateformes qui gèrent la responsabilité en matière de fraude et de litiges ou qui disposent de contrôles de plateforme peuvent ajuster l’intervalle des virements. La propriété interval accepte les quatre paramètres suivants :

manuel : ce paramètre empêche les virements automatiques. Vous devrez effectuer manuellement le virement du solde du compte à l’aide de l’API Payouts (en tant que compte connecté). Vous devez également configurer un compte sur manual pour utiliser les virements instantanés.
quotidien : ce paramètre assure le virement automatique des paiements delay_days dans les jours suivant leur création. La valeur delay_days ne peut pas être inférieure à votre propre fréquence de virement ou à la fréquence de virement par défaut du compte.
hebdomadaire : ce paramètre assure le virement automatique du solde au moins une fois par semaine le(s) jour(s) précisé(s) par le paramètre weekly_payout_days (une liste des jours de la semaine).
mensuel : ce paramètre assure le virement automatique du solde au moins une fois par mois, comme indiqué par le paramètre monthly_payout_days (une liste de nombres compris entre 1 et 31). Les virements normalement prévus entre le 29 et le 31 du mois sont effectués le dernier jour des mois plus courts.