secure_payment
POST - Créer un prélèvement garanti
| Argument | Description | Type - Taille | Exemple | Obligatoire |
|---|---|---|---|---|
| safedebit_consumer_reference | Référence Safedebit du consommateur | String - 35 | OUI | |
| umr | Identifiant unique du mandat | String - 35 | OUI | |
| amount | Montant total du prélèvement en centimes | String - 18 | OUI | |
| echeance_number | Nombre des prélèvements | String - 2 | OUI | |
| secure_type | Type de sécurisation | Char - 1 | Voir tableau en annexe | OUI |
| due_date | Date du premier prélèvement | String - 10 | DD/MM/YYYY | OUI |
| payment_reference | Référence du paiement | String - 64 | OUI | |
| sdd | Liste des références des prélèvements | Json | OUI | |
| motif ** | Motif du prélèvement | String - 128 | NON | |
| beneficiary_reference *** | Référence unique du bénéficiaire | String - 32 | NON | |
| url_callback | URL de retour | String - 128 | NON | |
*** Champ réservé MB.
Requête
POST /xxxx/secure_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",
"secure_type": "2",
"echeance_number": "2",
"sdd": [
"Reference-first-sdd",
"Reference-second-sdd"
],
"umr": "UMR_XXXXX",
"payment_reference": "Transaction-123",
"motif": "Paiement en 2 fois",
"url_callback": "https://mondomaine.fr/lien"}
Si le paiement a été validé avec succès
Réponse
{
"result" : true,
"status" : "VALIDATED",
"payment_reference" : "Transaction-123",
"safedebit_secure_reference" : "XXXXXX",
"sdd": [
{
"sdd_reference" : "Reference-first-sdd",
"amount" : "500",
"due_date" : "01/01/2018",
"status" : "CREATED"
},
{
"sdd_reference" : "Reference-second-sdd",
"amount" : "500",
"due_date" : "01/02/2018",
"status" : "WAITING"
}
]
}
Paiement en attente de validation
Réponse
HTTP/1.1 200 OK
Content-Type: application/json
{
"result" : true,
"status" : "PENDING",
"payment_reference": "Transaction-123",
"safedebit_secure_reference" : "XXXXXX",
"sdd":[
{
"sdd_reference" : "Reference-first-sdd",
"amount" : "500",
"due_date" : "01/01/2018",
"status" : "PENDING"
},
{
"sdd_reference" : "Reference-second-sdd",
"amount" : "500",
"due_date" : "01/02/2018",
"status" : "PENDING"
}
]
}
Si la création du paiement 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 |
||||||||
| status | Statut du paiement | ||||||||
| payment_reference | Référence du paiement | ||||||||
| safedebit_secure_reference | Référence Safedebit de garantie | ||||||||
| sdd | Liste des prélèvements
|
||||||||
| 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