Remboursements
Les remboursements annulent un paiement réussi. Whop les traite via le processeur de paiement d’origine. Le statut de l’adhésion correspondante se met à jour automatiquement.Émettre un remboursement
Créez les remboursements à partir d’un paiement, et non directement sur la ressource des remboursements. Appelezpayments.refund({ id }). Omettez partial_amount pour un remboursement total, ou transmettez-le pour un remboursement partiel.
Payment mis à jour. Le champ refunded_amount reflète le total cumulé remboursé. Vous pouvez appeler refund plusieurs fois pour un même paiement, jusqu’à son montant total.
Permission requise :
payment:manage. Ajoutez-la depuis le guide des permissions avant de publier votre application.Consulter les remboursements
Les remboursements disposent de leur propre ressource si vous devez les retrouver après coup.Litiges
Un litige (rétrofacturation) s’ouvre lorsque la banque de l’acheteur conteste un paiement. Vous disposez d’un délai pour répondre avec des preuves avant que la banque ne tranche. Whop vous transmet le litige, vous soumettez vos preuves, la banque statue et le litige est clos.Surveiller les litiges entrants
Trois événements auxquels vous abonner :Lister et récupérer
Répondre avec des preuves
La réponse aux litiges se fait en deux étapes : préparez vos preuves avecdisputes.update, puis soumettez-les avec disputes.submit. La mise à jour est idempotente. Vous pouvez modifier les champs jusqu’à la soumission.
Champs de preuve
Tous les champs sont facultatifs, mais plus vous en fournissez, plus votre réponse est solide. Les plus courants :
Les champs de pièce jointe acceptent un fichier téléversé sous la forme
{ id: file.id }. Téléversez-le d’abord via l’API Files.
Statuts des litiges
Le litige évolue au sein d’une machine à états. Il comporte deux phases : la phase d’alerte précoce (statuts préfixés parwarning_, signalés via dispute_alert.created) et la phase de litige formel. Voici tous les statuts que le SDK peut renvoyer :
Lorsqu’un litige est perdu, Whop ne crée pas automatiquement d’enregistrement de remboursement, et vous ne pouvez pas en créer un vous-même.
payments.refund rejette les appels portant sur un paiement contesté avec This payment has been disputed. Therefore, it cannot be refunded. Considérez le litige perdu comme la source de vérité, et n’attendez pas d’événement refund.created.Permissions
Ajoutez-les depuis le guide des permissions.
Étapes suivantes
Accepter des paiements
Le flux qui crée les paiements que vous rembourserez ou défendrez plus tard.
Écouter les webhooks
Réagissez côté serveur aux événements de remboursement et de litige.
Téléverser des fichiers
Téléversez des pièces jointes de preuve pour vos réponses aux litiges.
Référence de l'API Disputes
Ressource complète : champs, statuts et tous les endpoints.

