Payer en validation manuelle

La marketplace doit préciser avant l’exécution de la commande que le paiement s’effectuera avec une validation manuelle. Elle aura dans ce cas un délai (typiquement de 6 jours) pour ensuite modifier si besoin la commande, et envoyer une requête de validation manuelle.

• Étape 1 : Créer la commande avec validation manuelle

  Pour mettre en œuvre cette fonctionnalité, il suffit d'ajouter l'attribut awaiting_validation lors de la création de l'order et lui assigner la valeur true.

  Exemple d'appel POST ORDER de création en validation manuelle :

  POST https://secure.lyra.com/marketplace/v1/orders?expand=items

  {
    "marketplace": "ebfb36ab-2d30-4326-adb9-e16b0c9a89f3",
    "reference": "Exemple MKP BURO",
    "description": "Commande fournitures",
    "currency": "EUR",
    "url_return": "https://URLreturn.com",
    "awaiting_validation" : true,
    "items": [
      {
        "seller": "5d0ef88c-3345-4b33-948e-80e23d553b73",
        "reference": "STB1",
        "description": "Stylos bleus",
        "amount": 1150,
        "is_commission": false
      }
    ], 
    "buyer": 
      {
        "type": "PRIVATE",
        "email": "jean.dupont@acheteur.fr",
        "phone_number": "33 (0)1 11 22 33 44",
        "reference": "ZhIsYM"
      },
    "shipping": 
      {
        "shipping_method": "RELAY_POINT"
      }
  }

  Dans cet exemple, le montant de l'item (montant acheteur) est connu, mais pas sa répartition entre la part sous-marchand et la part de la commission de l'opérateur (la marketplace).

   Notez toutefois qu'il est possible de préciser dès cette étape les commissions de l'opérateur. Ces dernières pourront, si nécessaire, être mises à jour à l'étape 4.

• Étape 2 : Exécuter et obtenir le paiement de la commande

  L'étape 2 est exécutée de la même manière que pour un paiement standard et l'URL de redirection pour procéder au paiement est retournée.

  Exemple d'appel GET pour figer la commande :

  GET https://secure.lyra.com/marketplace/v1/marketplaces/orders/7fac13b0-7ab9-4382-9073-11ddb38d4427/execute

  Une fois le paiement effectué avec succès, la commande passe à l'état PENDING et les transactions associées au statut TO_VALIDATE.

  L'order étant en attente de validation, les contrôles sur le montant minimum de commission ne sont pas exécutés.

• Etape 3 : Modifier la commande (facultatif)
  A cette étape, la commande est payée, donc au statut PENDING et toujours modifiable dans les limites du montant de l’autorisation accordée à l’étape précédente. Il est donc ainsi possible par exemple :

  • d’ajouter ou de modifier un item commission
  • et/ou des commissions sur les articles ,
  • de supprimer des articles ou de modifier leur montant.

  En revanche, l'attribut awaiting_validation ne peut pas être modifié, c’est-à-dire qu’il est impossible de rebasculer la commande avec validation manuelle en commande « classique ».

• Etape 4 : Valider la commande
  Le processus se termine par la validation de l'order.

   Marketplace en prélèvement au fil de l'eau

  Pour les marketplace en prélèvement "CASHOUT", c'est lors de cette étape que le montant de la part opérateur marketplace est contrôlé.

  Pour valider un Order, il faut faire un POST sur l'URL de l'order, attribut validate.

  POST/orders/{order_uuid}/validateorders_validate

  Exemple d'appel POST ORDER pour le valider manuellement :

  POST https://secure.lyra.com/marketplace/v1/orders/7fac13b0-7ab9-4382-9073-11ddb38d4427/validate

  Exemple de retour du POST ORDER validate :

  Le détail de l'order est retourné. L'attribut awaiting_validation de l'order prend alors la valeur false et les transactions associées passent de l'état TO_VALIDATE à PENDING.

  {
     ...
    "reference": "Exemple MKP BURO 2",
    "description": "Commande fournitures",
    "awaiting_validation": false,
    ...
    "payment_config": "SINGLE",
    "amount": 1150,
    "initial_amount": 1150,
    "currency": "EUR",
    "status": "PENDING",
    ...
  }