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 Client au 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"
}