Les libraires peuvent utiliser un service web pour annuler une vente. Pour que la vente puisse être annulée, le libraire doit identifier la vente en fournissant les mêmes valeurs dans les paramètres que la vente originale. Seule les ventes dont le fichier n'a pas été téléchargé (le fichier filigrané ou le fichier de licence .acsm n'a pas été téléchargé) peuvent être annulées.
Déclaration
Adresse : /api/organisations/[organisation_id]/publications/[publication_id]/sales/cancel
Méthode : POST
Sécurité : HTTP/BASIC (Nom d'utilisateur et mot de passe)
Paramètres
organisation_id : (Obligatoire)
Id de l'organisation qui a fait la vente
publication_id : (Obligatoire)
Identifiant (ISBN, EAN ou clé interne) de la publication
customer_id : (Obligatoire)
Le customer_id de la vente à rembourser
transaction_id : (Obligatoire)
Le transaction_id de la vente à rembourser
amount : (Obligatoire)
Le montant du remboursement, qui doit correspondre au "cost" de la vente originale
reason : (Optionnel)
La raison du remboursement, optionnelle. Elle sera affichée à l'éditeur.
Réponses
200 : OK
Token. Le remboursement a été enregistré et un token est donné comme référence.
400 : refund_unauthorized
Le remboursement n'est pas autorisé car le contenu a été téléchargé par l'utilisateur.
400 : already_refunded
Cette vente a déjà été remboursée.
400 : cost_mismatch
Le montant ne correspond pas à celui de la vente originale.
401
Problème d'authentification utilisateur, ou l'utilisateur n'a pas le droit d'effectuer un remboursement.
404
La vente n'a pas été trouvée.