Importer les données de mandats existants sur plusieurs boutiques
POST .../multimandates
Il est possible d'importer les données de plusieurs mandats sur plusieurs boutiques de sociétés différentes (différents ICS) en une seule fois, sous condition d’avoir :
- Le même débiteur
- Le même iban.
La réponse contiendra :
- un mandat par boutique
- un objet JSON par boutique
Paramètres
| sites Identifiant de la ou des boutiques. Ex: ["11111111", "22222222"] | Array Requis |
| iban IBAN. Identifiant du compte bancaire du débiteur. | String Requis |
| last_name Nom du débiteur. | String Requis |
| first_name Prénom du débiteur. | String Requis |
| email E-mail du débiteur. | String Requis |
| payment_type Type de mandat :
| String Requis |
| locale Langue de génération du mandat. Code ISO 639-1 Alpha-2. Ex: FR, DE, ES, IT, EN, PT, PL, NL, SV | String Requis |
| bic BIC. Identifiant international de la banque du débiteur. | String Optionnel |
| title Civilité du débiteur. | String Optionnel |
| callback_url URL de callback appelée après l'import du mandat. | String Optionnel |
| send_mails Si ce champ est valorisé à True, Lyra Collect enverra les e-mails d'enregistrement du mandat à l'acheteur et au marchand à l'issue d'une opération de création ou de mise à jour d'un mandat. Valeur par défaut : False | Bool Optionnel |
| fetch_address Permet d'indiquer si l'objet address est retourné dans la réponse. Valeur par défaut : false. | Bool Optionnel |
| address Adresse du débiteur. | Recommandé |
Objet address
Certaines banques vérifient la présence de ces informations pour accepter une demande de prélèvement.
L'adresse est requise si le client possède un compte bancaire dans les départements, territoires ou pays suivants : Suisse, Monaco, Saint-Marin, Mayotte, Saint-Pierre-et-Miquelon, Guernesey, Jersey, Île de Man.
| country Code du pays suivant la norme ISO 3166 alpha-2. Ex: FR | String Recommandé |
| city Ville. | String Optionnel |
| district Quartier. | String Optionnel |
| state Etat / Région. | String Optionnel |
| street Nom de rue. | String Optionnel |
| street_number Numéro de voie. | String Optionnel |
| street2 Deuxième ligne d'adresse. | String Optionnel |
| zip Code postal. | String Optionnel |
Exemple
Requête
POST https://secure.lyra.com/sdd/multimandates{
"iban":"FR7630002005701234567890158",
"title":"M.",
"last_name":"Durand",
"first_name":"Michel",
"email":"mdurand@ymail.com",
"payment_type":"RECURR",
"locale":"FR",
"address":{
"street_number":"109",
"street":"rue de l'Innovation",
"street2":"Bat 1",
"district":"Labège-Innopole",
"zip":"31670",
"city":"Labège",
"country":"FR",
"state":"Occitanie"
},
"fetch_address":false,
"sites":["11111111","22222222","33333333"]
}Réponse
[
{
"bic":"CRLYFRPP",
"iban":"FR7630002005701234567890158",
"title":"M.",
"email":"mdurand@ymail.com",
"locale":"FR",
"identifier":"85d3fc75f08349dbabad6a0654cf61fb",
"rum":"85d3fc75f08349dbabad6a0654cf61fb",
"id":"11111111-85d3fc75f08349dbabad6a0654cf61fb",
"site":"11111111",
"first_name":"Michel",
"last_name":"Durand",
"payment_type":"RECURR",
"callback_url":null,
"created_at":1409136103000,
"updated_at":null,
"fetch_adress":"false"
},
{
"bic":"CRLYFRPP",
"iban":"FR7630002005701234567890158",
"title":"M.",
"email":"mdurand@ymail.com",
"locale":"FR",
"identifier":"f455bbd2009d431b923b7c759f6cd3a6",
"rum":"f455bbd2009d431b923b7c759f6cd3a6",
"id":"22222222-f455bbd2009d431b923b7c759f6cd3a6",
"site":"22222222",
"first_name":"Michel",
"last_name":"Durand",
"payment_type":"RECURR",
"callback_url":null,
"created_at":1409136105000,
"updated_at":null,
"fetch_adress":"false"
},
{
"bic":"CRLYFRPP",
"iban":"FR7630002005701234567890158",
"title":"M.",
"email":"mdurand@ymail.com",
"locale":"FR",
"identifier":"c57468616cf848ddb9bbdf39f31e0326",
"rum":"c57468616cf848ddb9bbdf39f31e0326",
"id":"33333333-c57468616cf848ddb9bbdf39f31e0326",
"site":"33333333",
"first_name":"Michel",
"last_name":"Durand",
"payment_type":"RECURR",
"callback_url":null,
"created_at":1409136108000,
"updated_at":null,
"fetch_adress":"false"
}
]Remarque
Si en retour un échec survient lors de l'importation d'un mandat, alors tous les mandats seront en échec.