Updating a mandate

The fields that can be subject to change are:

  • e-mail
  • IBAN

Note:

Even if the mandate update does not concern these two fields, they still must be present in the request.

In order to update a mandate:

  1. Specify the desired action on the first line: https://secure.lyra.com/sdd/mandates/[id]'

    Note: [id] allows to identify the exact mandate that you want to update.

  2. Build your http header (see chapter Identifying yourself when exchanging with the payment gateway).
  3. Add the email and iban fields required for updating mandate details.
    Table 1. Required fields
    Field name Format Description Required Example
    iban string IBAN for International Bank Account Number: Debtor’s bank account identifier
    "iban":"FR7630002005701234567890158"
    email string Debtor’s e-mail address
    "email":firstname.lastname@example.com

Example of a cURL request:

$ curl -k -X PUT -H 
"Content-type:application/json" -H 
"Authorization:Basic MTIzNDU2Nzg6MTIzNDU2Nzg5MDEyMzQ1Ng==
" https://..../mandates/12345678-67127d4f3c9e4f3c8f52ceaabd4ba11f --data 
'{"email":"new@email.com","iban":"FR76NOUVELIBAN"}'
Response:
HTTP/1.1 200 OK
Date: Wed, 27 Aug 2014 10:38:47 GMT
Content-Type:application/json
Connection: close
Transfer-Encoding:chunked 

{
	"title":"Mr",
	"email":"new@email.com",
	"identifier":"67127d4f3c9e4f3c8f52ceaabd4ba11f",
	"rum":"67127d4f3c9e4f3c8f52ceaabd4ba11f",
	"id":"12345678-67127d4f3c9e4f3c8f52ceaabd4ba11f",
	"site":"12345678",
	"first_name":"John",
	"last_name":"Smith",
	"created_at":1409135927000,
	"updated_at":null
}