Créer la demande de remboursement
Cette étape permet de créer la demande de remboursement en faisant un POST sur la ressource refund :
POST/refunds/refunds_create
A la création d’une demande de remboursement, les éléments suivants sont
contrôlés par l’API et font l’objet d’un code de retour d’erreur 400 s’ils ne sont pas
vérifiés :
- La commande à rembourser doit être dans l’état SUCCEEDED.
- Le vendeur qui rembourse doit être un des vendeurs de la commande remboursée.
- Le remboursement ne doit cibler qu’un seul vendeur. Si plusieurs vendeurs doivent rembourser une partie d’une même commande, plusieurs demandes de remboursements distinctes devront être créées : une pour chaque vendeur. La seule exception étant si le deuxième vendeur de la demande est le gestionnaire de la place de marché.
Le montant remboursé ne fait pas l’objet de contrôle à cette étape. Le contrôle a lieu ultérieurement, par les chaînes de traitement planifiées, ce qui se traduit par l’évolution du statut de la demande de traitement.
Exemple d’appel POST REFUND
Dans cet exemple de contenu JSON à poster, une demande de remboursement de 130€ est envoyée, dont 120€ à la charge du vendeur et 10€ à la charge du gestionnaire de la place de marché:
Requête
POST https://secure.lyra.com/marketplace/v1/refunds/
Corps
{
"order": "9537e049-8862-400a-ae8d-da2ec9ca6051",
"reference": "remb000045",
"description": "Remboursement Mme Lafont 001",
"currency": "EUR",
"items": [{
"seller": "dfc42a76-10b5-421a-91cd-c288c8265c92",
"reference": "remb000045a",
"description": "Phoneshop",
"amount": 12000
},
{
"seller":"975e2a43-7e72-438c-a2b2-b61347aa160c",
"reference":"remb000045b",
"description": "Gestionnaire",
"amount": 1000
}]
} Exemple réponse du POST REFUND
L'attribut amount en retour est calculé automatiquement à partir des montants postés de chacune des parts.
{
"uuid": "16ad9da8-b9cb-11e4-97c6-b1229586dec7",
"href":"https://secure.lyra.com/marketplace/v1/refunds/16ad9da8-b9cb-11e4-97c6-b1229586dec7",
"created_at": "2018-06-08T12:36:56.681073Z",
"updated_at":"2018-06-08T12:39:46.859402Z",
"order": "9537e049-8862-400a-ae8d-da2ec9ca6051",
"reference": "remb000045",
"description": "Remboursement Mme Lafont 001",
"amount":13000,
"currency": "EUR",
"status":"CREATED",
"items": [ {
"seller": "dfc42a76-10b5-421a-91cd-c288c8265c92",
"reference": "remb000045a",
"description":"Phoneshop",
"amount":12000,
"is_commission": false
},
{
"seller":"975e2a43-7e72-438c-a2b2-b61347aa160c",
"reference": "remb000045b",
"description": "Gestionnaire",
"amount": 1000,
"is_commission": false
}]
}