Informations personnelles d'un client unique
Contrairement au Customer, il est créé indépendamment d'un objet Payment, et peut être réutilisé.
Le champ identifier fournit lors de sa création permet de le lier au compte client chez le marchand afin de le réutiliser lors de la création des prochains paiements pour ce client.
C'est avec cet identifier que l'objet Client peut être récupéré chez Alma et être modifié.
| Champ | Type | Description |
|---|---|---|
addresses | list of Address | List d'objets Address représentant les adresses connues du client |
bank_accounts | list of Bank Account | Liste d'objets BankAccount |
business_id_number | string (optionnel) | Numéro d'enregistrement de l'entreprise (SIREN pour les entreprises Françaises) |
business_name | string (optionnel) | Nom de l'entreprise |
created | timestamp | Date de création du Client |
email | string | Email du client (particulier) ou du point de contact dans l'entreprise (professionnel) |
first_name | string | Prénom du client (particulier) ou du point de contact dans l'entreprise (professionnel) |
id | string | Identifiant du client (côté Alma) |
identifier | string | Identifiant unique du client (côté marchand) |
is_business | boolean | true si le client est une entreprise (false par défaut) |
last_name | string | Nom du client (particulier) ou du point de contact dans l'entreprise (professionnel) |
phone | string | Téléphone du client (particulier) ou du point de contact dans l'entreprise (professionnel) |
Exemple d'objet
Clientau format JSON
{
"addresses": [],
"bank_accounts": [
{
"account_number": "FR76 •••• •••• •••• •••• ••• 5751",
"id": "customer_bank_account_11ikV2kndRqVJMBkGwU2kIYkseMc4phrL4",
"mandate": {
"accept_date": 1577373655,
"accepted": true,
"account_number": "FR76 •••• •••• •••• •••• ••• 5751",
"url": "https://hooks.stripe.com/adapter/sepa_debit/file/src_1Fty3JAvsaNcXrV7rd2nU6i6/src_client_secret_GQpikrw6VAhyxpAxRZgGlK77"
},
"owner_name": "Me Mee"
}
]
"business_id_number": "100 200 300",
"business_name": "Merchant Inc",
"created": 1577373816,
"email": "[email protected]",
"first_name": null,
"id": "client_11ikUzC31gwcHBkHAqImmwUmW2sKO1L3zO",
"identifier": "MY_CUSTOMER_001",
"is_business": true,
"last_name": null,
"phone": "+33623780000"
}