Skip to main content
Deux choses peuvent se produire après qu’un paiement a abouti. Les remboursements sont une annulation que vous (ou votre équipe d’assistance) émettez délibérément. Les litiges sont des rétrofacturations que l’acheteur dépose auprès de sa banque. Vous ne contrôlez pas toujours l’issue d’un litige, mais vous pouvez y répondre avec des preuves.
Abonnez-vous aux webhooks pour refund.created, refund.updated, dispute.created, dispute.updated et dispute_alert.created afin de rapprocher les changements de statut sans interrogation périodique.

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. Appelez payments.refund({ id }). Omettez partial_amount pour un remboursement total, ou transmettez-le pour un remboursement partiel.
La réponse est l’objet 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 avec disputes.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 par warning_, 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.