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