Créer plusieurs mandats en une seule fois

Il est possible de créer plusieurs mandats sur plusieurs boutiques en une seule fois, sous condition d’avoir :

  • Le même débiteur
  • Le même iban

A la différence de la création d’un seul mandat, les données qui diffèrent sont:

  • un nouveau point d’accès : POST .... /multimandates
  • un paramètre supplémentaire sites : [ n° de boutique ]

La réponse contiendra :

  • un mandat par boutique
  • un tableau JSON par boutique

Pour créer plusieurs mandats :

  1. Spécifiez dès la première ligne l'action souhaitée : https://secure.payzen.eu/sdd/multimandates'
  2. Construisez votre en-tête http (voir chapitre S'identifier lors des échanges).
  3. Ajoutez les champs requis iban, last_name, first_name, email, payment_type, locale et sites à la création des mandats.
    Tableau 1. Champs obligatoires
    Champ Format Description Requis Exemple
    iban string IBAN pour International Bank Account Number : Identifiant du compte bancaire du débiteur
    "iban":"FR7630002005701234567890158"
    last_name string Nom du débiteur
    "last_name":"Durand"
    first_name string Prénom du débiteur
    "first_name":"Michel"
    email string E-mail du débiteur
    "email":"prenom.nom@exemple.com
    payment_type string
    • RECURR
    • ONEOFF

    Type de mandat :
    • Récurrent
      Le mandat signé vaut pour une série de prélèvements.
    • Ponctuel
      Le mandat signé vaut pour un prélèvement unique.

    "payment_type":"RECURR"

    ou

    "payment_type":"ONEOFF"

    locale string
    • FR pour le Français
    • DE pour l'Allemand
    • EN pour l'Anglais
    • ES pour l'Espagnol
    • IT pour l'Italien
    • NL pour le Néerlandais
    • PL pour le Polonais
    • PT pour le Portugais
    • SV pour le Suédois
    Langue de génération du mandat

    "locale":"FR"

    sites n8 Identifiant de la / des boutique(s)
    "sites":["11111111", "22222222"]
  4. Ajoutez les champs optionnels bic, title, callback_url et send_mails si nécessaire.
Tableau 2. Champs facultatifs
Champ Format Description Exemple
bic string BIC pour Bank Identifier Code : Identifiant international de la banque du débiteur "bic":"CRLYFRPP"
title string Civilité du débiteur "title":"M."
callback_url string URL https://.../
send_mails boolean

Valeur par défaut : False

Si ce champ est valorisé à True, le PDF PayZen 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.

 
Exemple de requête cURL:
$ curl 'https://..../multimandates' -H
'Authorization: Basic Mjk2MjgyNTM6Mzg4OTExNDQ5MzM4NjI5Nw==' -H'
Content-Type:application/json' -H 
'Accept: application/json' 
--data
'{"iban":"FR7630002005701234567890158","title":"M.","last_name":"Durand",
"first_name":"Michel",
"email":"mdurand@ymail.com","payment_type":"RECURR","locale":"FR",
"sites":["17068344","97176631","27303624","99477756","57356166","43305819","80158999","15283256"]}'
          -i

Réponse:

HTTP/1.1 200 OK
Date: Wed, 27 Aug 2014 10:41:42 GMT
Content-Type:application/json
Connection: close
Transfer-Encoding:chunked

[
{
"bic":"CRLYFRPP",
"iban":"FR7630002005701234567890158",
"title":"M.",
"email":"mdurand@ymail.com",
"locale":"FR",
"identifier":"FR08ZZZ482829-20140827vzP6s8",
"rum":"FR08ZZZ482829-20140827vzP6s8",
"id":"17068344-FR08ZZZ482829-20140827vzP6s8",
"site":"17068344",
"first_name":"Michel",
"last_name":"Durand",
"payment_type":"RECURR",
"callback_url":null,
"created_at":1409136103000,
"updated_at":null
},
{
"bic":"CRLYFRPP",
"iban":"FR7630002005701234567890158",
"title":"M.",
"email":"mdurand@ymail.com",
"locale":"FR",
"identifier":"FR78ZZZ472548-20140827TotVyn",
"rum":"FR78ZZZ472548-20140827TotVyn",
"id":"97176631-FR78ZZZ472548-20140827TotVyn",
"site":"97176631",
"first_name":"Michel",
"last_name":"Durand",
"payment_type":"RECURR",
"callback_url":null,
"created_at":1409136105000,
"updated_at":null
},
{
"bic":"CRLYFRPP",
"iban":"FR7630002005701234567890158",
"title":"M.",
"email":"mdurand@ymail.com",
"locale":"FR",
"identifier":"FR78ZZZ472548-20140827iliSfW",
"rum":"FR78ZZZ472548-20140827iliSfW",
"id":"27303624-FR78ZZZ472548-20140827iliSfW",
"site":"27303624",
"first_name":"Michel",
"last_name":"Durand",
"payment_type":"RECURR",
"callback_url":null,
"created_at":1409136108000,
"updated_at":null
},
{
"bic":"CRLYFRPP",
"iban":"FR7630002005701234567890158",
"title":"M.",
"email":"mdurand@ymail.com",
"locale":"FR",
"identifier":"FR78ZZZ472548-20140827IbVhav",
"rum":"FR78ZZZ472548-20140827IbVhav",
"id":"99477756-FR78ZZZ472548-20140827IbVhav",
"site":"99477756",
"first_name":"Michel",
"last_name":"Durand",
"payment_type":"RECURR",
"callback_url":null,
"created_at":1409136111000,
"updated_at":null
},
{
"bic":"CRLYFRPP",
"iban":"FR7630002005701234567890158",
"title":"M.",
"email":"mdurand@ymail.com",
"locale":"FR",
"identifier":"FR45ZZZ473627-20140827odyhp5",
"rum":"FR45ZZZ473627-20140827odyhp5",
"id":"57356166-FR45ZZZ473627-20140827odyhp5",
"site":"57356166",
"first_name":"Michel",
"last_name":"Durand",
"payment_type":"RECURR",
"callback_url":null,
"created_at":1409136113000,
"updated_at":null
},
{
"bic":"CRLYFRPP",
"iban":"FR7630002005701234567890158",
"title":"M.",
"email":"mdurand@ymail.com",
"locale":"FR",
"identifier":"FR53ZZZ483086-20140827MDq84e",
"rum":"FR53ZZZ483086-20140827MDq84e",
"id":"43305819-FR53ZZZ483086-20140827MDq84e",
"site":"43305819",
"first_name":"Michel",
"last_name":"Durand",
"payment_type":"RECURR",
"callback_url":null,
"created_at":1409136116000,
"updated_at":null
},
{
"bic":"CRLYFRPP",
"iban":"FR7630002005701234567890158",
"title":"M.",
"email":"mdurand@ymail.com",
"locale":"FR",
"identifier":"FR58ZZZ655850-20140827JiLH9P",
"rum":"FR58ZZZ655850-20140827JiLH9P",
"id":"80158999-FR58ZZZ655850-20140827JiLH9P",
"site":"80158999",
"first_name":"Michel",
"last_name":"Durand",
"payment_type":"RECURR",
"callback_url":null,
"created_at":1409136118000,
"updated_at":null
},
{"bic":"CRLYFRPP",
"iban":"FR7630002005701234567890158",
"title":"M.",
"email":"mdurand@ymail.com",
"locale":"FR",
"identifier":"FR04ZZZ655852-20140827UVZH2u",
"rum":"FR04ZZZ655852-20140827UVZH2u",
"id":"15283256-FR04ZZZ655852-20140827UVZH2u",
"site":"15283256",
"first_name":"Michel",
"last_name":"Durand",
"payment_type":"RECURR",
"callback_url":null,
"created_at":1409136121000,
"updated_at":null
}
]

Remarque

Si en retour un échec survient sur la création d'un mandat, alors tous les mandats seront en échec.