Analyser le résultat du paiement

Si l'adresse du webhook de l'objet order est définie, le serveur de la marketplace est notifié pour chaque changement de statut des objets order.

Cette notification est envoyée en POST avec l'entête Content-Type: application/json.

Pour des raisons de sécurité et de simplicité, elle se compose uniquement de la propriété "order" et de l'uuid de la commande correspondante.

Exemple de notification (webhook)

{"order":"515abac9-6cb2-4e21-8a25-b08d7e41e43c"}

En PHP, ce Json peut être récupéré par le code suivant :

$json = file_get_contents('php://input');
$data = json_decode($json);
$orderUuid = $data->order ?? false;

Il appartient ensuite à la Marketplace d'appeler la ressource GET ORDER (ou TOKEN) avec l'UUID communiqué afin de connaître le nouvel état de l'objet en question.

GET/orders/{uuid}orders_read

Exemple d'appel GET ORDER

GET https://secure.lyra.com/marketplace/v1/orders/515abac9-6cb2-4e21-8a25-b08d7e41e43c

Exemple de réponse GET ORDER

{
  "uuid": "515abac9-6cb2-4e21-8a25-b08d7e41e43c",
  "href": "https://secure.lyra.com/marketplace/v1/orders/515abac9-6cb2-4e21-8a25-b08d7e41e43c",
  "created_at": "2015-03-19T16:30:14.434Z",
  "updated_at": "2015-03-19T16:30:14.434Z",
  "marketplace": "9537e049-8862-400a-ae8d-da2ec9ca6051",
  "reference": "cmd00052",
  ...
  "status": "PENDING",
  "webhook_result": 200,
  ...
}

A ce stade, voici la signification des différents statuts :

Statut	Signification
PENDING	Le paiement s'est déroulé avec succès. La ou les transactions correspondantes sont créées et en attente de remise, ou éventuellement en attente de validation manuelle.
FAILED	L'acheteur a renseigné le formulaire de paiement mais le moyen de paiement n'a pas été reconnu ou validé. Les transactions correspondantes sont générées et `FAILED`.
CREATED	L'acheteur n'a pas soumis le formulaire.
ABANDONNED	L'acheteur n'a pas soumis le formulaire et la commande est considérée comme abandonnée.

Notez que la commande envoie aussi la propriété webhook_result avec le statut de la réponse de votre serveur, tel qu'enregistré par notre serveur.

Catégories

Tags

Analyser le résultat du paiement