Skip to main content
Il existe deux façons d’encaisser des paiements pour des sous-comptes :
  1. Débits directs : créez un checkout pour le sous-compte et prélevez des frais d’application.
  2. Transferts : encaissez le paiement sur le compte de votre plateforme et transférez ultérieurement les fonds aux sous-comptes.

Débits directs

Créez une configuration de checkout avec l’ID d’un sous-compte pour débiter les clients directement sur ce sous-compte. Le sous-compte prend en charge les frais Whop, les remboursements et les litiges.

Fonctionnement

  1. Créez une configuration de checkout pour votre sous-compte avec un application_fee_amount
  2. Lorsqu’un client effectue un achat, Whop crée le débit directement sur le sous-compte
  3. Votre plateforme perçoit les frais d’application, et le montant restant revient au sous-compte
  4. Le sous-compte gère les éventuels litiges ou remboursements liés à la transaction

Exemple

Créez une variante en ligne à l’aide de l’entrée de compatibilité nommée plan.
Dans cet exemple :
  • account_id est l’ID du sous-compte sur lequel Whop créera le débit
  • variant.initial_price est le montant total du paiement de la variante (10,00 dollars américains)
  • variant.application_fee_amount correspond aux frais perçus par votre plateforme (1,23 dollar américain)
  • Le sous-compte reçoit 8,77 dollars américains (10,00 - 1,23)

Limites

  • application_fee_amount doit être positif et inférieur au montant total du paiement
  • Les frais d’application ne peuvent pas dépasser le montant du paiement capturé

Transferts

Utilisez les transferts lorsque votre plateforme encaisse d’abord le paiement, ou lorsque votre backend décide du montant et du moment du versement à chaque sous-compte.

Avant de transférer

  • Compte d’origine : le compte qui envoie les fonds doit avoir réussi la vérification Know Your Customer (KYC) et disposer d’un solde suffisant pour le transfert. Vous pouvez approvisionner le solde depuis le tableau de bord ou via Ajouter des fonds à votre solde.
  • Compte de destination : le destinataire doit déjà avoir un compte Whop. Si ce n’est pas le cas, intégrez-le d’abord avec Inscrire des sous-comptes.
  • Responsabilité du règlement : avec les transferts, votre plateforme est le marchand officiel (merchant of record) du paiement d’origine. Votre plateforme gère les frais, les litiges et les remboursements liés à ce paiement.

Exemple

Encaissez le paiement sur le compte de votre plateforme, puis transférez la part du sous-compte :
Dans cet exemple :
  • origin_id est l’ID du compte de votre plateforme (sur lequel Whop prélève les fonds)
  • destination_id est l’ID du sous-compte (sur lequel Whop crédite les fonds)
  • amount est le montant à transférer
  • metadata stocke des données personnalisées pour votre référence

Gérer les échecs de transfert

Les transferts échouent si le compte d’origine n’est pas vérifié, si son solde est insuffisant ou si le compte de destination ne peut pas encore recevoir de fonds. Corrigez la cause sous-jacente avant de réessayer. Ne relancez pas un transfert échoué sans en avoir examiné la cause.

Usages courants

  • Versements planifiés aux créateurs
  • Versements aux affiliés
  • Répartitions de marketplace après le règlement d’une commande

Choisir un flux de paiement

Utilisez les transferts lorsque votre backend contrôle le calendrier et le montant des versements. Utilisez les débits directs lorsque le sous-compte doit assumer les frais, les litiges et les remboursements de l’achat d’origine.

Référence de l’API

Create Checkout Configuration

Créez des configurations de checkout avec des frais d’application

Create Transfer

Transférez des fonds entre comptes

Accepter des paiements

Découvrez les liens de checkout et l’élément Checkout

Inscrire des sous-comptes

Créez les comptes destinataires et finalisez leur onboarding avant de leur verser des fonds