Paiement par Titres-Restaurant Dématérialisés

L’application Marketplace permet le paiement partiel ou en intégralité des items du panier au moyen de Titres-Restaurant dématérialisés (TRD).

Cette fonctionnalité ne concerne que les marketplaces éligibles TRD.

Elle nécessite au préalable de renseigner les contrats TRD des marchands dans la marketplace.

  1. Configuration des marchands

    Les marchands sont configurés via le Back Office Marketplace ou lors de la procédure d’enrôlement. Le numéro de contrat TRD du marchand lui est affecté en renseignant l'attribut trd_contract.

    Exemple de POST REGISTRATION (extrait) :
    {       
    "marketplace": "d085b6bb-4b8e-4f23-b84a-c9e5fafaf3dd",      
    "name": "Acme Corporation",      
    "person_type": "PM",      
    "trading_name": "Acme Corp.",       
    "nature": "SARL",       
    "reference": "registration002",       
    "trd_contract": "1234567",       
    "iban": "FR76000000000000000000",       
    "vat_number": "FRXX123456789",      
    "legal_form": 5710,       
    "external_ref": "000123",       
    …

  2. Préparation de la commande

    Pour chaque item éligible à un paiement TRD, indiquez le montant maximum payable en TRD au moment de créer l’order dans la marketplace. Ce montant est renseigné par l’attribut max_trd_amount et il ne représente pas obligatoirement l’intégralité du montant de l’item.

    Exemple de POST ORDER avec des items éligibles TRD :
    {
    	"marketplace": "d085b6bb-4b8e-4f23-b84a-c9e5fafaf3dd",
    	"reference": "cmd00054",
    	"description": "Commande éligible paiement TRD",
    	"currency": "EUR",
    	"url_return": "https://lyra.com/doc/fr/",
    	"language":"fr",
    	"capture_delay": 3,
    	"items": [
    			{
    				"seller": "fa740b68-d873-4eab-9639-88a8ac413e42",
    				"reference": "demoeYDPnZuC",
    				"description": "Bon menu",
    				"amount": 1500,
    				"type": "FOOD_AND_GROCERY",
    				"is_commission": false,
    				"max_trd_amount": 1000
    			},
    			{
    				"seller": "fa740b68-d873-4eab-9639-88a8ac413e42",
    				"reference": "azraty",
    				"description": "Bon vin",
    				"amount": 2000,
    				"type": "FOOD_AND_GROCERY",
    				"is_commission": false
    			},
    			{
    				"seller": "4d20a9d4-0526-4474-b452-e936dc25418d",
    				"reference": "pemo9knR",
    				"description": "Bon café",
    				"amount": 500,
    				"type": "FOOD_AND_GROCERY",
    				"is_commission": false,
    				"max_trd_amount": 500
    			},
    				],
    				"buyer": {
    						"type": "PRIVATE",
    						"email": "paulette17@goncalves.org",
    						"phone_number": "+33 (0)5 11 08 12 32",
    						"reference": "ZhIsYM"
    						},
    				"shipping": 
    						 {
    							"address": 
    							{
    							"zipcode": "59259",
    							"street_number": "37",
    							"country": "FR",
    							"state": "Meurthe-et-Moselle",
    							"street": "rue Marcel Philippe",
    							"district": "Wallis-et-Futuna",
    							"city": "Dupont"
    							},
    							"shipping_method": "ETICKET",
    							"delay": 2
    						}
    }
    							
    						

    Exemple de POST ORDER avec des items mixtes TRD et non TRD :
    {
    	"marketplace": "d085b6bb-4b8e-4f23-b84a-c9e5fafaf3dd",
    	"reference": "cmd00077",
    	"description": "Commande éligible paiement TRD et NON TRD",
    	"currency": "EUR",
    	"url_return": "https://lyra.com/doc/fr/",
    	"language":"fr",
    	"items": [
    			{
    				"seller": "fa740b68-d873-4eab-9639-88a8ac413e42",
    				"reference": "jambonbeurre",
    				"description": "Restaurant",
    				"amount": 1550,
    				"quantity": 1,
    				"max_trd_amount": 1550
    			},
    			{
    				"seller": "fa740b68-d873-4eab-9639-88a8ac413e42",
    				"reference": "mug",
    				"description": "MugDuRestaurant",
    				"amount": 950,
    				"quantity": 1
    			},
    			{
    				"seller": "fa740b68-d873-4eab-9639-88a8ac413e42",
    				"reference": "commisison",
    				"description": "commission",
    				"amount": 160,
    				"quantity": 1,
    				"is_commission": true
    			},
    				],
    				"buyer": {
    						"type": "PRIVATE",
    						"email": "paulette17@goncalves.org",
    						"phone_number": "+33 (0)5 11 08 12 32",
    						"reference": "ZhIsYM"
    						},
    				"shipping": 
    						 {
    							"address": 
    							{
    							"zipcode": "59259",
    							"street_number": "37",
    							"country": "FR",
    							"state": "Meurthe-et-Moselle",
    							"street": "rue Marcel Philippe",
    							"district": "Wallis-et-Futuna",
    							"city": "Dupont"
    							},
    							"shipping_method": "ETICKET",
    							"delay": 2
    						}
    }
    							
    						

    Au moment du GET sur l’order pour figer la commande, le montant total de la commande est calculé ainsi que le montant éligible au paiement TRD.

    Un seul marchand par commande peut être payé par TRD.

    Pour ce faire, l’application utilise l’algorithme de sélection suivant :
    • calcul du montant total payable en TRD par marchand
    • sélection du marchand qui a le plus haut montant payable en TRD

    Si le montant éligible est identique entre plusieurs marchands, celui avec le plus petit numéro de contrat sera sélectionné.

    Le numéro de contrat du marchand sélectionné est ajouté dans la commande pour être envoyé à la plateforme de paiement ainsi que le montant éligible.

  3. Paiement

    Le paiement est géré par la plateforme Lyra Collect.

    • Paiement total en TRD

      Le montant intégral de la commande est payé à l’aide du TRD. Une seule transaction est générée dans la marketplace.

    • Paiement partiel en TRD

      Le montant éligible TRD est inférieur au montant total de la commande, l'acheteur utilise un Titre-Restaurant pour payer la partie éligible finançable par TRD puis complète le restant-dû avec un autre moyen de paiement.

      On parle de paiement en cascade car il y a 2 moyens de paiement associés donc 2 transactions distinctes sont générées dans la marketplace.

    REMARQUE

    Même si sa commande est éligible à un paiement TRD, l’acheteur peut décider de ne pas payer par Titre-Restaurant Dématérialisé.

    Il est possible d’annuler une commande comprenant des transactions CONECS. En revanche, la modification d’une transaction CONECS n’est pas possible.