create_consumer
POST -- Création d’un nouveau consommateur
| Argument | Description | Type - Taille | Exemple | Obligatoire |
|---|---|---|---|---|
| consumer_type | Type du consommateur | String - 1 | 0: Particulier 1: Société 2: Association | OUI |
| consumer_reference | Référence commerçant du consommateur | String - 64 | NON | |
| consumer_store | Référence boutique Safedebit | String - 32 | NON | |
| consumer_gender | Genre du consommateur | Char - 1 | M : masculin F : féminin | NON |
| consumer_last_name | Nom du consommateur | String - 70 | OUI | |
| consumer_first_name | Prénom du consommateur | String - 70 | OUI | |
| consumer_other_last_name | Autres prénoms | String - 70 | NON | |
| identity_type | Type de la pièce d'identité | Char - 1 | 1 : CNI 2 : permis 3 : passeport 4 : carte résident 5 : carte de séjour | OUI * |
| id_number | Numéro de la pièce d'identité | String - 18 | OUI * | |
| emission_date | Date d'émission de la pièce | String - 10 | DD/MM/YYYY | OUI * |
| expire_date | Date d'expiration de la pièce | String - 10 | DD/MM/YYYY | OUI * |
| consumer_birth_date | Date de naissance | String - 10 | DD/MM/YYYY | NON |
| consumer_birth_city | Ville de naissance | String - 35 | NON | |
| nationality | Nationalité du consommateur | String - 2 | FR,ES,IT... | NON |
| consumer_address_street_number | Adresse du consommateur : numéro sur la voie | String - 16 | OUI | |
| consumer_address_street_type | Adresse du consommateur : type de voie | String - 16 | OUI | |
| consumer_address_street_name | Adresse du consommateur : nom de la voie | String - 70 | OUI | |
| consumer_address_complement | Complément d'adresse | String - 70 | NON | |
| consumer_zip_code | Code postal | String - 16 | OUI | |
| consumer_city | Ville | String - 35 | OUI | |
| consumer_country | Pays | String - 35 | NON | |
| consumer_email | Email du consommateur | String - 70 | OUI | |
| consumer_phone_number | Téléphone du consommateur | String - 16 | OUI | |
| consumer_ip | Adresse IP du consommateur | String - 16 | NON | |
| iban | IBAN du compte bancaire du consommateur | String - 34 | OUI | |
| beneficiary_reference | Référence unique du bénéficiaire | String - 32 | OUI * |
Société (consumer_type = 1)
| Argument | Description | Type - Taille | Obligatoire |
|---|---|---|---|
| social_reference | Raison sociale | String - 32 | OUI |
| siren | SIREN de la société | String - 9 | OUI |
| nic | NIC de la société | String - 5 | NON |
| naf | NAF de la société | String - 32 | NON |
| tva_interco | TVA inter communautaire de la société | String - 32 | NON |
Association (consumer_type = 2)
| Argument | Description | Type - Taille | Obligatoire |
|---|---|---|---|
| social_reference | Raison sociale | String - 32 | NON |
| siren | SIREN de la société | String - 9 | OUI |
| nic | NIC de la société | String - 5 | NON |
| naf | NAF de la société | String - 32 | NON |
| tva_interco | TVA inter communautaire de la société | String - 32 | NON |
| waldec | Numéro national unique de l'association | String - 10 | OUI |
Requête
POST /xxxx/create_consumer HTTP/1.1
Host: xxx.xxxxxxxx.fr
Authorization: Basic JQheySHkalSNuakkmSmm==
Content-Type: application/json
Accept: application/json
{
"consumer_type": "0",
"consumer_reference": "12345",
"consumer_gender": "M",
"consumer_last_name": "Prenom",
"consumer_first_name": "Nom",
"consumer_birth_date": "01/01/1990",
"consumer_birth_city": "Ville",
"nationality": "FR",
"consumer_address_street_number": "1",
"consumer_address_street_type": "Rue",
"consumer_address_street_name": "du test",
"consumer_address_complement": "",
"consumer_zip_code": "00000",
"consumer_city": "Ville",
"consumer_country": "FR",
"consumer_email": "test@test.com",
"consumer_phone_number": "0000000000",
"identity_type": "1",
"id_number": "92017410",
"emission_date": "01/01/2010",
"expire_date": "01/01/2020",
"iban": "FR76XXXXXXXXXXXXXXXXXXXXXXX"}
Réponse
HTTP/1.1 200 OK
Content-Type: application/json
{
"result" : true,
"safedebit_consumer_reference":"123456789"
}
Réponse
POST /ssp/create_consumer HTTP/1.1
Host: xxx.safedebit.fr
Authorization: Basic JQheySHkalSNuakkmSmm==
Content-Type: application/json
Accept: application/json
{
"result" : false,
"code" : "XXXX"
}
| Argument | Description |
|---|---|
| result | true ou false : true : action réalisée avec succès false : action échouée |
| safedebit_consumer_reference | Référence Safedebit du consommateur |
| code | Voir codes d'erreur en annexe. |
Requête
HTTP/1.1 200 OK
POST /ssp/create_consumer HTTP/1.1
Host: xxx.safedebit.fr
Authorization: Basic JQheySHkalSNuakkmSmm==
Content-Type: application/json
Accept: application/json