Créer un mandat

Pour créer un mandat :

  1. Spécifiez l'action souhaitée : https://secure.payzen.eu/sdd/mandates
  2. Construisez votre en-tête http (voir chapitre S'identifier lors des échanges).
  3. Ajoutez les champs iban, last_name, first_name, email, payment_type et locale requis à la création du mandat.
    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"

  4. Ajoutez les champs optionnels bic, title, callback_url et send_mails si nécessaire.
    Tableau 2. Champs facultatifs
    Nom du 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://..../mandates' -H'
Authorization:Basic NDExMzQ3MjE6MzY2MjM2ODE4MjMwNDY0Mg==' -H'
Content-Type:application/json' -H 
'Accept: application/json' --data
'{"bic":"iban":"FR7630002005701234567890158","title":"M.","last_name":"Durand",
"first_name":"Michel","email":"mdurand@ymail.com","payment_type":"RECURR","locale":"FR"}' -i

Réponse:
HTTP/1.1 200 OK
Date: Wed, 27 Aug 2014 10:38:47 GMT
Content-Type:application/json
Connection:close
Transfer-Encoding:chunked 

{
	"title":"M.",
	"email":"mdurand@ymail.com",
	"identifier":"DE98ZZZ09999999999-20140827onGTun",
	"rum":"DE98ZZZ09999999999-20140827onGTun",
	"id":"41134721-DE98ZZZ09999999999-20140827onGTun",
	"site":"41134721",
	"first_name":"Michel",
	"last_name":"Durand",
	"created_at":1409135927000,
	"updated_at":null
}