Gérer la fréquence des virements

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

Remarque

Ce guide explique comment configurer les virements en utilisant l’API des Paramètres solde. Utilisez lesParamètres solde pour gérer les paramètres de virement des comptes v2. L’objet Paramètres solde suit une structure et un fonctionnement similaires au hachage settings.payouts des comptes v1. Si vous utilisez actuellement settings.payouts sur les comptes v1, vous pouvez continuer à le faire.

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 daily 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.