edit_sdd
POST -- Modify a SDD
Modification of the amount of a guaranteed levy is not allowed and for the date (due_date), it depends on management rules defined by contract.
Only SDD in processing state are allowed to be changed.
| Search argument | Description | Max size | Mandatory |
|---|---|---|---|
| sdd_reference | SDD reference | String - 35 | YES |
| Search arguments specified for the merchant SPS only | Description | Type - Length | Mandatory |
|---|---|---|---|
| umr | Unique mandate reference | String - 35 | YES |
| ics | Beneficary's SEPA | String - 35 | YES |
| Parameter to modify | Description | Type - Length | Example | Mandatory |
|---|---|---|---|---|
| due_date | Levy deadline | String - 10 | DD/MM/YYYY | NO |
| motif | Reason of levy | String - 128 | NO | |
| amount | Levy amount in cents | String - 18 | NO | |
| payment_reference | Payment reference | String - 64 | NO | |
Request
POST /xxxx/edit_sdd HTTP/1.1
Host: xxx.xxxxxxxx.fr
Authorization: Basic JQheySHkalSNuakkmSmm==
Content-Type: application/json
Accept: application/json
{
"sdd_reference": "REF_XXX",
"umr": "REF_XXX",
"ics": "XXXXX",
"due_date": "01/01/2018",
"amount": "100",
"motif": "new_motif",
"payment_reference": "REF_XXXX"}
a) Levy successfully modified,
(amount and date doesn't change the terms of the levy)
Response
HTTP/1.1 200 OK
Content-Type: application/json
{
"result" : true
}
b) Levy successfully modified,
(amount or date changes the terms of the levy)
Response
HTTP/1.1 200 OK
Content-Type: application/json
{
"result" : true,
"safedebit_secure_reference" : "SF_XXXXXX"
}
If levy modification failed
Response
HTTP/1.1 200 OK
Content-Type: application/json
{
"result" : false,
"code" : "XXXX"
}
| Argument | Description |
|---|---|
| result | true or false : true : action succeeded false : action failed |
| safedebit_secure_reference | Safedebit guarantee reference |
| code | See (error codes in annex). |
Request
HTTP/1.1 200 OK
POST /ssp/edit_sdd HTTP/1.1
Host: xxx.safedebit.fr
Authorization: Basic JQheySHkalSNuakkmSmm==
Content-Type: application/json
Accept: application/json