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 : https://secure.lyra.com/marketplace/refunds/

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 PENDING ou SUCCEEDED
  • Le vendeur qui rembourse doit être un des vendeurs de la cpommande 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é.

Remarque : 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 formulée, dont 120€ à la charge du vendeur et 10€ à la charge du gestionnaire de la place de marché:

{
	"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

Le champ 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/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 
	}]
}