Déclenchement manuel du paiement des items

Dans la cinématique normale, le paiement d'un item de commission intervient automatiquement après l'expiration du délai de blocage des fonds du vendeur lié à l'item.

Il peut arriver que la marketplace souhaite retenir ce paiement afin de contrôler le moment de son déclenchement.

C'est notamment le cas d'une prestation qui s'étale dans le temps. Dans ce cas le client a effectué son paiement avant le début de la prestation, mais le vendeur ne doit reçevoir sa contrepartie que suite à la vérification par la marketplace du bon déroulement de la prestation.

Il appartient alors à la marketplace :
  • d'indiquer lors de la création de la commande le ou les items concernés par le blocage du paiement, en valorisant le champ hold_payment à true:
      "items": [
        {
            "seller": "4d20a9d4-0526-4474-b452-e936dc25418d",
            "reference": "croisiere12345",
            "description": "Croisiere en bateau",
            "amount": 245000,
            "quantity": 1,
             "is_commission": false,
            "hold_payment": true 
        },
        { 
            "seller": "4d20a9d4-0526-4474-b452-e936dc25418d",
            "reference": "cartemaritime",
            "description": "Carte maritime - La Martinique",
            "amount": 1250, "quantity": 1, 
            "is_commission": false 
        },
       { 
            "seller": "72ccc2ff-b455-4653-847e-deb6fee99f8d", 
            "reference": "croisiere12345com", 
            "description": "Commission sur croisiere en bateau", 
            "amount": 16450, 
            "quantity": 1, 
            "is_commission": true 
        } 
        ] 
  • et, au moment voulu, de libérer le transfert en effectuant une requête POST (sans corps de requête) à l'adresse :
    POST /items/{id_item}/activate

En cas de succès de l'opération, la requête est redirigée (status_code = 302) vers le détail de l'item, qui indique alors hold_payment : false.

Remarque :
  • Le blocage ne peut concerner les items de panier d'un vendeur de type Marketplace (seller avec "is_marketPlace = true").
  • Une fois le paiement de l'item activé, il n'est plus possible de le bloquer à nouveau .
  • Le champ hold_payment n'est pas obligatoire. Il est même préférable de l'omettre (ou bien de le valoriser à "hold_payment : null") pour tout item dont le transfert doit être géré automatiquement, afin de distinguer les items ayant fait l'objet d'un blocage des autres.