initier_sct


POST  - Initiation d'un paiement par virement


Argument Description Type - Taille Exemple Obligatoire
safedebit_reference_patient Référence Safedebit du patient (référence unique par patient générée par SSP et retournée à l’éditeur suite à la création du mandat) String - 35 OUI
(seulement si le patient est existant)
reference_regie Référence unique de la régie de l’établissement de santé String - 32 OUI
id_patient Référence commerçant du patient que l’éditeur doit transmettre. Etant donné qu’un même identifiant patient peut être  utilisé par 2 éditeurs différents, chaque éditeur doit ajouter un incrément à ses identifiants patient afin d’éviter un blocage lié au contrôle des doublons effectué par SSP. String - 35 OUI *
reference_paiement Référence du paiement qui doit être transmise par l'éditeur String - 64 OUI
sms_option Option d'envoi du lien de paiement par sms Char - 1 OUI
email_option Option d'envoi du lien de paiement par email Char - 1 OUI
url_ko URL d'erreur String - 128 https:// OUI **
url_cancel URL d'annulation String - 128 https:// OUI **
patient_prenom Prénom du patient String - 70 OUI
patient_nom Nom du patient String - 70 OUI
patient_numero_mobile Téléphone du patient String - 16 OUI
patient_email Email du patient String - 70 OUI
montant Montant total en centimes String - 18 OUI
url_ok URL de confirmation String - 128 https:// OUI **
url_rappel URL de notification String - 128 https:// OUI **




Requête

POST /xxxx/initier_sct HTTP/1.1
Host: xxx.xxxxxxxx.fr
Authorization: Basic JQheySHkalSNuakkmSmm==
Content-Type: application/json
Accept: application/json 


{
"safedebit_reference_patient": "XXXXXX",
"id_patient": "XXXXXX",
"montant": "1000",
"reference_paiement": "Commande 12345",
"sms_option": "1",
"email_option": "1",
"url_ok": "https://.......",
"url_ko": "https://.......",
"url_cancel": "https://.......",
"url_rappel": "https://.......",
"patient_nom": "Dupont",
"patient_prenom": "Jean",
"patient_numero_mobile": "0615985048",
"patient_email": "jean.dupont@gmail.com"}


Si le lien de paiement par virement a été généré avec succès

Réponse

HTTP/1.1 200 OK
Content-Type: application/json 


{
    "result" : true,
    "lien" : "https://xxxxx"
}


Si la génération du lien de paiement par virement 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
lien Lien de paiement par virement
code Voir codes d'erreur en annexe.

Callback

Après la validation du paiement par virement une notification est envoyée vers l'url : url_callback aves les paramètres suivants


Argument Description
reference_paiement Référence du paiement/commande
statut_paiement VALIDATED,CANCELED,ERROR
montant Montant total en centimes
date_validation Date de validation
safedebit_reference_patient Référence Safedebit du patient
Merci de remplir tous les champs obligatoires
Requête

HTTP/1.1 200 OK
POST /ssp/initier_sct HTTP/1.1
Host: xxx.safedebit.fr
Authorization: Basic JQheySHkalSNuakkmSmm==
Content-Type: application/json
Accept: application/json