get_fee
POST - Charge a comission/a bill on customer
| Search parameter | Description | Type - Length | Example | Mandatory |
|---|---|---|---|---|
| beneficiary_reference | Unique reference of beneficiary | String - 32 | YES | |
| amount * | Total levy amount in cents | String - 18 | YES | |
| due_date | Direct debit due date | String - 10 | DD/MM/YYYY | YES |
| sdd_reference | SDD reference | String - 35 | YES | |
| motif ** | Reason of levy | String - 128 | NO | |
Request
POST /xxxx/get_fee HTTP/1.1
Host: xxx.xxxxxxxx.fr
Authorization: Basic JQheySHkalSNuakkmSmm==
Content-Type: application/json
Accept: application/json
{
"beneficiary_reference": "XXXXXX",
"amount": "1000",
"due_date": "01/01/2018",
"sdd_reference": "REF_xxxx",
"motif": "Prélèvement facture 1"}
If levy successfully created (levy validated)
Response
{
"result" : true,
"status" : "CREATED",
"sdd_reference": "REF_xxxx",
"due_date" : "DD/MM/YYYY",
"safedebit_secure_reference" : "XXXXXX"
}
If levy successfully created (waiting for validation)
Response
{
"result" : true,
"validation_type":"OTP",
"status" : "PENDING",
"sdd_reference": "REF_xxxx",
"due_date" : "DD/MM/YYYY",
"safedebit_secure_reference" : "XXXXXX"
}
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 |
| sdd_reference | sdd reference |
| due_date | Direct debit due date (DD/MM/YYYY) |
| safedebit_secure_reference | Safedebit guarantee reference |
| validation_type | Type of validation : OTP (sms) PIN (PIN code) FCID (FaceId) TCID(TouchId) |
| code | See (error codes in annex). |
Request
HTTP/1.1 200 OK
POST /ssp/Get_fee HTTP/1.1
Host: xxx.safedebit.fr
Authorization: Basic JQheySHkalSNuakkmSmm==
Content-Type: application/json
Accept: application/json