Skip to main content
Il s’agit de l’étape précédant une rétrofacturation : l’acheteur et le marchand règlent le problème directement, et Whop tranche le dossier s’ils n’y parviennent pas. Utilisez l’API Resolution Center Cases de part et d’autre : en tant qu’acheteur, pour ouvrir un dossier, y répondre, faire appel ou le retirer ; en tant que marchand, pour l’accepter (en remboursant le paiement), le refuser ou demander des informations supplémentaires à l’acheteur.

Endpoints

Attributs

string
requis
ID du dossier du centre de résolution, préfixé par reso_.
object | null
requis
Le compte contre lequel le dossier a été déposé.

Propriétés

string
requis
ID du compte, préfixé par biz_.
string
requis
Nom d’affichage du compte.
number
requis
Le montant en question, en unités entières de currency.
string[]
requis
Ce que vous pouvez faire sur ce dossier en ce moment, nommé d’après l’endpoint correspondant. Résolu pour l’identifiant appelant, de sorte qu’un marchand et un client consultant le même dossier voient chacun leurs propres options.Options disponibles : accept, deny, request_info, reply, appeal, withdraw
object
requis
Le client qui a ouvert le dossier.

Propriétés

string | null
requis
L’adresse e-mail du client. Nécessite le scope member:email:read ; null sans celui-ci.
string | null
requis
L’enregistrement de membre du client sur le compte, préfixé par mem_.
string | null
requis
Le nom d’affichage du client.
string | null
requis
L’ID utilisateur du client, préfixé par user_.
string | null
requis
Le nom d’utilisateur Whop du client.
string
requis
Date d’ouverture du dossier, sous forme d’horodatage ISO 8601.
string | null
requis
Code de devise ISO à trois lettres du montant.
boolean
requis
Indique si le client a fait appel d’une décision sur ce dossier.
boolean
requis
Indique si Whop est impliqué — soit en examinant le dossier, soit en attendant de la partie désignée par status un élément demandé pendant l’examen.
object[]
requis
Tout ce que le paiement contesté a facturé, dans l’ordre d’achat. product_id et variant_id désignent le premier de ces éléments ; les éléments suivants d’un panier n’apparaissent qu’ici. Un paiement effectué avant l’enregistrement des articles indique l’unique article qu’implique sa variante. Vide lorsque le paiement n’est lié à aucune variante.

Propriétés

string | null
requis
ID de l’article, préfixé par li_. Null lorsque le paiement est antérieur aux instantanés d’articles et que l’article est lu à partir de la variante du paiement.
string | null
requis
Le nom de l’article tel qu’affiché au paiement (le titre du produit, sinon le titre de la variante).
string | null
requis
Le produit auquel appartient la variante, préfixé par prod_. Pour un paiement antérieur aux instantanés d’articles, la valeur se rabat sur le produit de la variante ; elle peut donc être définie alors que le product_id du parent est null. Null pour une variante sans produit.
string | null
requis
Le titre actuel du produit, ou null si l’article n’a pas de produit.
number
requis
Nombre d’unités achetées.
string | null
requis
L’unité de gestion de stock (SKU) de la variante, texte libre défini par le vendeur (par ex. TSHIRT-LARGE-BLUE). Les comptes pour lesquels les suffixes de SKU selon le motif de facturation sont activés la reçoivent marquée du motif du prélèvement : -S pour un premier prélèvement d’abonnement, -R pour un renouvellement, -C pour un achat unique, -U lorsque les métadonnées du paiement contiennent upsell: true, -F lorsque rien n’a été prélevé. Les autres motifs de facturation portent le SKU seul. null lorsque la variante n’a pas de SKU ou a été supprimée.
object | null
requis
Le montant enregistré pour la quantité totale de cet article, avant réductions, taxes et frais, dans sa devise d’achat. Renvoie null si aucun montant d’article n’a été enregistré.

Propriétés

string
requis
Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, "10.00" correspond à dix dollars. Il s’agit d’une chaîne afin qu’aucun nombre à virgule flottante ne l’arrondisse en transit.
string
requis
Code de devise ISO 4217 à trois lettres, en minuscules.
integer
requis
Nombre de décimales du montant. Il s’agit de la précision à laquelle le prélèvement lui-même est effectué.
integer
requis
Nombre de décimales à AFFICHER. Généralement égal à decimals, mais délibérément pas toujours : le COP est prélevé en centavos mais écrit en pesos entiers, ce qui donne 2 et 0. Utilisez cette valeur pour formater le nombre selon vos propres paramètres régionaux.
string | null
requis
La variante achetée, préfixée par plan_. Null si la variante a depuis été supprimée.
string | null
requis
Le titre actuel de la variante, ou null si la variante a été supprimée ou n’a pas de titre.
string | null
requis
La partie qui a obtenu gain de cause. null jusqu’à la clôture du dossier. Consultez refund pour savoir si de l’argent a réellement été transféré.Options disponibles : customer_won, merchant_won, withdrawn
object
requis
Le paiement contre lequel le dossier a été ouvert.

Propriétés

string
requis
ID du paiement, préfixé par pay_.
string | null
requis
Marque de la carte, lorsque le client a payé par carte.
string | null
requis
Quatre derniers chiffres de la carte, lorsque le client a payé par carte.
string
requis
Date du paiement, sous forme d’horodatage ISO 8601.
string | null
requis
Moyen de paiement utilisé par le client, par exemple card ou paypal.
string | null
requis
Le produit concerné par le paiement, préfixé par prod_.
string
requis
Le problème signalé par le client. Utilise le même vocabulaire que /disputes, de sorte qu’un dossier qui devient ensuite une rétrofacturation indique la même réclamation.Options disponibles : fraudulent, product_not_received, not_as_described, product_unacceptable, subscription_canceled
string | null
requis
Indique si de l’argent a été transféré et depuis quel solde : none, merchant ou platform (Whop a remboursé le client et le marchand a conservé les fonds). Indépendant de outcome — un dossier remporté par le marchand peut tout de même comporter un remboursement par la plateforme. null tant que le dossier est ouvert, ainsi que pour les anciens dossiers clos antérieurs à l’enregistrement de cette information.Options disponibles : none, merchant, platform
string | null
requis
Date limite de la prochaine réponse, sous forme d’horodatage ISO 8601.
string
requis
La partie dont le dossier attend une action. awaiting_merchant et awaiting_customer désignent la partie qui doit répondre, under_review signifie que Whop est en train de statuer, et closed signifie que le dossier est réglé — consultez outcome pour connaître l’issue.Options disponibles : awaiting_merchant, awaiting_customer, under_review, closed
string
requis
Date de la dernière modification du dossier, sous forme d’horodatage ISO 8601.
string | null
requis
La variante sur laquelle le paiement a été effectué, préfixée par plan_.
ResolutionCenterCase