payment
POST - Créer un prélèvement
| Argument | Description | Type - Taille | Exemple | Obligatoire |
|---|---|---|---|---|
| amount | Montant à sécuriser en centimes | String - 18 | OUI | |
| due_date | Date de prélèvement | String - 10 | DD/MM/YYYY | OUI |
| sdd_reference | Référence du prélèvement | String - 35 | OUI | |
| motif ** | Motif du prélèvement | String - 128 | NON | |
| umr | Identifiant unique du mandat | String - 35 | NON | |
| safedebit_consumer_reference | Référence Safedebit du consommateur | String - 35 | OUI | |
| beneficiary_reference *** | Référence unique du bénéficiaire | String - 32 | NON | |
| url_callback | URL de retour | String - 128 | NON | |
SNCF
| Argument | Description | Type - Taille | Exemple | Obligatoire |
|---|---|---|---|---|
| url_callback_status | Url de rappel | String - 128 | NON | |
| account_data | field.account_data.label is missing | JSON Object | {"ref_lettrage":"xxxxxxxxxxx","pdv_emetteur_ventes":"87111222","postes_de_ventes":"001","type_operation":"1","date":"20210401","montant":"200.00","signe":"E/D"} | NON |
*** Champ réservé MB.
Requête
POST /xxxx/payment HTTP/1.1
Host: xxx.xxxxxxxx.fr
Authorization: Basic JQheySHkalSNuakkmSmm==
Content-Type: application/json
Accept: application/json
{
"safedebit_consumer_reference": "XXXXXX",
"amount": "1000",
"due_date": "01/01/2018",
"sdd_reference": "REF_xxxx",
"motif": "Prélèvement facture 1",
"umr": "UMR_XXXXX",
"url_callback": "https://mondomaine.fr/lien"}
Si le prélèvement a été créé avec succès (Prélèvement validé)
Réponse
HTTP/1.1 200 OK
Content-Type: application/json
{
"result" : true,
"status" : "CREATED",
"sdd_reference": "REF-xxxx",
"due_date" : "DD/MM/YYYY",
"payment_reference" : "XXXXXXX"
}
Si le prélèvement a été créé avec succès (En attente de validation)
Réponse
HTTP/1.1 200 OK
Content-Type: application/json
{
"result" : true,
"validation_type":"OTP",
"status" : "PENDING",
"sdd_reference": "REF_xxxx",
"due_date" : "DD/MM/YYYY"
}
Si la création du prélèvement a échoué
Réponse
HTTP/1.1 200 OK
Content-Type: application/json
{
"result" : false,
"code" : "XXXX"
}
| Argument | Description |
|---|---|
| result | true ou false : true : action réalisée avec succès false : action échouée |
| sdd_reference | Référence du prélèvement (sdd) |
| due_date | Date de prélèvement (DD/MM/YYYY) |
| validation_type | Type de validation : OTP (sms) PIN (code PIN) FCID (FaceId) TCID(TouchId) |
| code | Voir codes d'erreur en annexe. |
Requête
HTTP/1.1 200 OK
POST /ssp/payment HTTP/1.1
Host: xxx.safedebit.fr
Authorization: Basic JQheySHkalSNuakkmSmm==
Content-Type: application/json
Accept: application/json