Modifier une commande

Il est possible de modifier un Order tant qu'il possède un statut transitoire (CREATED ou PENDING).

La transaction initiale ne doit donc pas être remisée en banque.

Dans le cas d'un Order au statut CREATED, toutes les valeurs sont modifiables, sans restriction (voir l'étape 2 du chapitre Réaliser un paiement).

Dans le cas d'un Order au statut PENDING, la commande PUT est rejetée si les deux valeurs suivantes sont identiques à celles du dernier enregistrement :

  • amount, déterminé à partir de la somme des montants des items.
    La requête de modification annule et remplace l'ensemble des items de l'Order initial.
  • expected_capture_date en UTC au format YYYYMMDDHHMMSS.
    La comparaison des expected_capture_date ne tient compte que de la date.
    Par exemple, 20200101100000 (1er janvier 2020 à 10h UTC) est équivalent à 20200101180000 (1er janvier 2020 à 18h UTC).

Par ailleurs
  • le montant ne peut être supérieur au montant initial de la commande (cf. valeur enregistrée à la clé initial_amount),
  • les items doivent être obligatoirement transmis dans la requête PUT (?expand=items).

Exemple d'appel PUT ORDER :

PUT https://secure.lyra.com/marketplace/orders/515abac9-6cb2-4e21-8a25-b08d7e41e43c?expand=items

{
	"marketplace": "ebfb36ab-2d30-4326-adb9-e16b0c9a89f3",
	"reference": "Exemple MKP BURO",
	"description": "Commande fournitures",
	"currency": "EUR",
	"url_return": "https://URLreturn.com",
	"expected_capture_date" : "202006205352",
	"items": [{
		"seller": "d0f80202-0676-4d8d-9247-f455f30aec1b",
		"reference": "commburo",
		"description": "commission BURO",
		"amount": 150,
		"is_commission": true
	},
	{
		"seller": "5d0ef88c-3345-4b33-948e-80e23d553b73",
		"reference": "STV1",
		"description": "Stylos verts",
		"amount": 1000,
		"is_commission": false
	},
	{
		"seller": "d0f80202-0676-4d8d-9247-f455f30aec1b",
		"reference": "liv",
		"description": "Livraison",
		"amount": 500,
		"is_commission": false
	}
	],
	"buyer": {
		"type": "PRIVATE",
		"email": "jean.dupont@acheteur.fr",
		"phone_number": "+33 (0)1 11 22 33 44",
		"reference": "ZhIsYM"
	},
	"shipping": {
		"address": {
			"zipcode": "59123",
			"street_number": "37",
			"country": "FR",
			"street": "rue Marcel Philippe",
			"city": "Nantes"
		},
		"shipping_method": "RELAY_POINT"
	}
}