Étape 1: Créer le vendeur

Cette étape permet de créer la demande d’enrôlement du vendeur en faisant un POST sur la ressource REGISTRATION avec ses informations complètes.

POST : https://secure.lyra.com/marketplace/registrations/

A la création d’un nouveau vendeur, les éléments suivants sont contrôlés par l’API et font l’objet d’un code de retour d’erreur 40X s’ils ne sont pas valides :

  • Vérification que les champs obligatoires sont renseignés
  • Vérification qu’au moins un représentant légal est spécifié et que ses coordonnées sont précisées
  • Vérification que chaque adresse mail spécifiée est unique dans le système
  • Vérification qu’il y a une (et une seule) activité principale renseignée
  • Pour chaque activité, un identifiant doit être renseigné (SIRET ou legal_identifier)
  • Vérification qu’il n’y a pas de doublon sur les identifiants d’activité au cas où plusieurs activités sont renseignées (i.e. le SIRET ne doit être rattaché qu’à une seule activité).

Le tableau ci-dessous liste les champs à fournir en appel à la création d'une demande d’enrôlement

Vérifiez que chaque devise supportée par la Marketplace est correctement assignée à un IBAN;

Nom Description Format Obligatoire
marketplace Identifiant de la marketplace ans..36 X
reference Référence technique de l’enrôlement ans..255 X
description Description de l’enrôlement ans..255
person_type

PM : Personne morale

PP : Personne Physique

 X
title Pour les personnes physiques : MR, MS ou MRS Si person_type = PP
first_name Pour les personnes physiques : Prénom Si person_type = PP
last_name Pour les personnes physiques : Nom Si person_type = PP
name Nom du vendeur ans..255 X
trading_name Pour les personnes morales : Nom commercial ans..255 Si person_type = PM
nature Raison sociale ans..255
iban IBAN de paiement ans..34 X
vat_number Numéro de TVA ans..16 X
legal_form Forme juridique ans..4 X
economic_agent Code ISO d’agent économique (exemple : "ISO_301") ans..255 X
external_ref Référence externe du vendeur (Pourra être utilisé comme identifiant des vendeurs dans les autres API) ans.50
turnover Chiffre d’affaire estimé (en centimes) numérique X
cashout_delay Délai de déblocage des fonds (en jours) ans..180
address Adresse de la société du vendeur X
address.street_number Numéro de voie ans..5
address.street Type de voie ans..255
address.district Complément d’adresse ans..127
address.zipcode Code postal ans..64 X
address.city Ville ans..128 X
address.state Etat/Province ans..127
address.country Code pays sur 2 lettres (code ISO 3166-1 alpha-2) ans..2 X
board Représentant légal [LEGAL_REP] et liste des bénéficiaires effectifs [BENEFICIARY] A minima le représentant légal
board.role Qualité de la personne au sein de la société [LEGAL_REP| BENEFICIARY] X
board.title Civilité de la personne [MR|MS|MRS] X
board.first_name Prénom de la personne ans..63 X
board.last_name Nom de la personne ans..63 X
board.birth_date Date de naissance de la personne Date au format YYYY-MM-DD X
board.birth_city Ville de naissance de la personne ans..128 X
board.nationality Nationalité de la personne (code ISO 3166-1 alpha-2 du pays) ans..2 X
board.phone_number Numéro de téléphone de la personne ans..32 X
board.email Adresse e-mail de la personne ans..150 X
board.address Adresse personnelle de la personne (Note : les mêmes champs que pour l’adresse d’entreprise sont nécessaires pour l’adresse de chacune des personnes transmises) X
activities Liste des activités du vendeur
activity.name Enseigne de la boutique Texte X
activity.url Adresse Internet de la boutique ans..200
activity.registration_date Date d’immatriculation de l’activité Date au format YYYY-MM-DD X
activity.siret Identifiant SIRET de l’activité ans..14
activity.legal_identifier Identifiant légal de l’activité ans..20
activity.mcc Code MCC (merchant category code) ans..4 X
activity.naf_code Code NAF ans..5
activity.is_principal Indique s’il s’agit de l’activité principale du vendeur [true|false] X

Exemple d'appel POST REGISTRATION

{ 
       "marketplace": "d085b6bb-4b8e-4f23-b84a-c9e5fafaf3dd", 
       "reference":
       "registration002",
       "description": "Vendeur Acme Corp 20180116",       
       "person_type": "PM",
       "name": "Acme Corporation",
       "trading_name": "Acme Corp.",
       "nature": "SARL",
       "iban": "FR76300040000XXXXXXXXXX0143",
       "vat_number": "FRXX123456789",
       "legal_form": 5710,
       "economic_agent": "ISO_305",
       "external_ref": "acmeref", 
       "turnover": 100000000,
       "address":{
               	"zipcode": "12345",
               	"street_number": "4",
               	"country":"FR",
               	"street": "rue des Souris",
               	"city": "BOUVISE"
					},
       "board":  [               
					{                       
        			"role": "LEGAL_REP","title": "MR",                       
        			"first_name": "Thomas",                       
        			"last_name": "Coyote",                       
        			"birth_date": "1949-09-17",                       
        			"birth_city": "BURBANK",                       
        			"nationality": "FR",                       
       			 "phone_number": "0123456789",                       
        			"email": "thomas@acme.com",                       
					 "address": {
                  			"zipcode": "12345", 
                  			"street_number": "12",
                  			"country": "FR", 
                  			"street":  "grande rue",
                  			"city": "PARIS"                      
								  }               
     				}
					  ],
        "activities":
					  [               
      			   {                       
        			"name": "Acme Tennis Ball",                       
        			"url": "http://www.acmezzz.com",                       
        			"registration_date": "2017-03-24",                       
        			"siret": "99556699889944",                       
        			"mcc": "5995",                       
        			"naf": "4623Z",                       
       			 "legal_identifier": "995566998",                       
        			"is_principal": "true"
                	}
        			 ]
}