Après le paiement, interpréter les contrats utilisés
Le choix du moyen de paiement et le montant réellement payé par contrat n'est connu qu'à l'issue du cycle de paiement.
Dans la perspective marketplace, cette information n'est donc disponible qu'à partir du moment où le statut de la commande est passé à PENDING.
Si un voucher a été utilisé, l'attribut actual_amount renseigne sur le montant réellement affecté à l'article.
... "status":"PENDING", "amount":8000, "items":[{ "uuid":"fc300ee2-fd43-46e0-9314-770f05a5b338", ... "reference":"Buffet1", "description":"Buffet 1", "type":"FOOD", "amount":8000, ... "vouchers":[{ "contract_type":"CVCONNECT", "is_selected":true, "actual_amount":3000 }, { "contract_type":"CONECS", "eligible_amount":1400, "is_selected":true, "actual_amount":1100 }] }]
On constate dans cet exemple que l'acheteur a utilisé 11€ sur une carte CONECS, plus 30 € sur un Chèque-Vacances. Puisque le montant total est de 80 €, on s'attend donc à avoir une troisième transaction avec le complément (soit 80 - 30 - 11 = 39 €).
Étant donné qu'une commande peut contenir plusieurs articles payables par voucher, l'API répartit automatiquement les actual_amount dans un ordre arbitraire. Par exemple,
... "items":[{ "reference":"Buffet1", "description":"Buffet 1", "type":"FOOD", "amount":8000, ... "vouchers":[{ "contract_type":"CONECS", "eligible_amount":1400, "is_selected":true, "actual_amount":1400 }] }, { "reference":"Buffet2", "description":"Buffet 2", "type":"FOOD", "amount":5500, ... "vouchers":[{ "contract_type":"CONECS", "eligible_amount":1100, "is_selected":true, "actual_amount":500 }] }, { "reference":"Buffet3", "description":"Buffet 3", "type":"FOOD", "amount":5500, ... "vouchers":[{ "contract_type":"CONECS", "eligible_amount":1100, "is_selected":true, "actual_amount":0 }] }] ...
Dans ce cas de figure, l'acheteur semble avoir utilisé le montant de son crédit quotidien de 19 €, qui a été réparti sur le premier article pour la totalité (soit 14 €), sur le second pour une partie (soit 5 €), et rien sur le troisième.
- 11 € sur le Buffet 2;
- 8 € sur le Buffet 3;
- 0 € sur le Buffet 1.