Précision sur les données contextuelles attendues dans les paiements
L'objet paiement dispose d'une variable cart.items[] permettant de spécifier un ensemble de valeurs lié au contenu du panier. Ces données enrichies permettent :
- d'améliorer la détection et la prévention de la fraude
- de mieux connaitre les habitudes clients
Et ainsi d'améliorer la performance globale (acception, conversion, ...) avec Alma.
Données communes
Chaque élément du panier peut-être décrit à l'aide de ces champs:
| Champ | Type | Commentaire |
|---|---|---|
payment.cart.items[] | Liste d'objets | Contient les éléments de panier |
payment.cart.items[].sku | string | Identifiant produit |
payment.cart.items[].vendor | string | Marque du produit vendu |
payment.cart.items[].title | string | Nom du produit |
payment.cart.items[].variant_title | string | Autre nom possible du produit |
payment.cart.items[].quantity | integer | Quantité du produit |
payment.cart.items[].unit_price | integer | Prix du produit unitaire en centimes |
payment.cart.items[].line_price | integer | Total du prix en centimes |
payment.cart.items[].is_gift | boolean | Marquer le produit comme offert |
payment.cart.items[].categories | Liste de strings | Catégorie du produit |
payment.cart.items[].url | string | Lien URL de la page produit |
payment.cart.items[].picture_url | string | Lien URL de l'image du produit |
payment.cart.items[].requires_shipping | boolean | Préciser si livraison physique nécessaire |
payment.cart.items[].tax_included | boolean | Préciser si le prix est TTC |
payment.cart.items[].extra_data[] | Objet | Voir sections ci-dessous |
Autres éléments relatifs au paiement :
| Champ | Type | Commentaire |
|---|---|---|
payment.cart.discounts[] | Liste d'objets | Précise les détails en cas de réduction |
payment.cart.discounts[].title | string | Nom de la campagne marketing |
payment.cart.discounts[].amounts | integer | Montant du rabais en centimes |
{
"payment": {
...
"cart": {
"items": [
{
"sku": "XXXXXXXXXX",
"vendor": "mattel",
"title": "pink sofa ",
"variant_title": "pink sofa - Barbie edition",
"quantity": 1,
"unit_price": 25000,
"line_price": 25000,
"is_gift": false,
"categories": [
"furniture",
"home",
"decoration"
],
"url": "https://www.xxxx.com",
"picture_url": "https://www.yyyy.com",
"requires_shipping": true,
"taxes_included": true
}
],
"discounts": [ // optional - discounts applied to the purchase
{
"title": "welcome to pink world",
"amount": 5000
}
]
}
}
}Activités spécifiques
Selon les activités exercées, il est demandé de fournir des données spécifiques additionnelles permettant à notre algorithme de mieux scorer vos clients, considérant les particularités de vos industries. Dès lors que vous exercez une de ces activités, ces données sont requises.
Ces données doivent être précisées dans la variable payment.cart.items[].extra_data[]
Si vous n'êtes pas toujours en mesure de fournir les données demandées ci-dessous au moment du paiement, des canaux de partage asynchrones sont envisageables: nos équipes techniques sont à disposition pour en parler.
Train
Nécessaires pour les paiement incluant des voyages ferroviaires
| Champ | Type | Description | Valeurs autorisées |
|---|---|---|---|
payment.cart.items[].extra_data[].type | string | train | |
payment.cart.items[].extra_data[].departure_date | datetime | Date de départ | ISO 8601 |
payment.cart.items[].extra_data[].departure_station | string | Gare de départ | |
payment.cart.items[].extra_data[].arrival_station | string | Gare d'arrivée | |
payment.cart.items[].extra_data[].train_number | string | Numéro de train |
{
"payment": {
...
"cart": {
"items": {
"title": "Train ticket",
"quantity": 1,
"line_price": 10000,
"extra_data": [
{
"type": "train",
"departure_date": "2026-06-13T09:45:00Z",
"departure_station": "Lyon - Part Dieu",
"arrival_station": "Paris - Gare de Lyon",
"train_number": "0000"
}
]
}
}
}
}Vol
Nécessaires pour les paiement incluant des voyages aériens
| Champ | Type | Description | Valeurs autorisées |
|---|---|---|---|
payment.cart.items[].extra_data[].type | string | flight | |
payment.cart.items[].extra_data[].refund_policy | string | Règles relatives au remboursement et à l'échange des billets | exchangeable · refundable · both · null |
payment.cart.items[].extra_data[].departure_date | datetime | Date de départ | ISO 8601 |
payment.cart.items[].extra_data[].departure_airport | string | Aéroport de départ | IATA airport code |
payment.cart.items[].extra_data[].arrival_airport | string | Aéroport d'arrivée | IATA airport code |
payment.cart.items[].extra_data[].flight_number | string | Numéro de vol | |
payment.cart.items[].extra_data[].travel_class | string | Classe | economy · business · first |
payment.cart.items[].extra_data[].passenger_count | integer | Nombre de passager | ≥ 1 |
payment.cart.items[].extra_data[].passengers[].type | string | Type de passager | PTC |
{
"payment": {
...
"cart": {
"items": {
"title": "Flight ticket",
"quantity": 1,
"line_price": 10000,
"extra_data": [
{
"type": "flight",
"arrival_airport": "LIS",
"departure_airport": "CDG",
"departure_date": "2026-06-13T09:45:00Z",
"flight_number": "XXXXX",
"passenger_count": 2,
"passengers": [
{
"type": "ADT"
},
{
"type": "ADT"
}
],
"refund_policy": "refundable",
"travel_class": "economy"
}
]
}
}
}
}Hébergement
Nécessaires pour les paiement incluant des activités de tourisme, hébergement et autre locations de logements saisonniers
| Champ | Type | Description | Valeurs autorisées |
|---|---|---|---|
payment.cart.items[].extra_data[].type | string | accommodation | |
payment.cart.items[].extra_data[].check_in | datetime | Date d'arrivée | ISO 8601 |
payment.cart.items[].extra_data[].check_out | datetime | Date de départ | ISO 8601 |
payment.cart.items[].extra_data[].booking_reference | string | Référence | |
payment.cart.items[].extra_data[].room_count | integer | Nombre de chambres | |
payment.cart.items[].extra_data[].guest_count | integer | Nombre de personnes | ≥ 1 |
{
"payment": {
...
"cart": {
"items": {
"title": "One night at a hotel",
"quantity": 1,
"line_price": 10000,
"extra_data": [
{
"type": "accommodation",
"booking_reference": "XXXXX",
"check_in": "2026-06-13T15:00:00Z",
"check_out": "2026-06-14T10:00:00Z",
"guest_count": 2,
"room_count": 1
}
]
}
}
}
}Assurance
Nécessaires pour les paiement incluant des activités assurantielles
| Champ | Type | Description | Valeurs autorisées |
|---|---|---|---|
payment.cart.items[].extra_data[].type | string | insurance | |
payment.cart.items[].extra_data[].operator_name | string | Nom de la compagnie d'assurance | |
payment.cart.items[].extra_data[].policy_number | string | Numéro d'assurance | |
payment.cart.items[].extra_data[].coverage_start_date | datetime | Date de début | ISO 8601 |
payment.cart.items[].extra_data[].coverage_end_date | datetime | Date de fin | ISO 8601 |
payment.cart.items[].extra_data[].insured_amount | integer | Montant couvert |
{
"payment": {
...
"cart": {
"items": {
"title": "One-day insurance",
"quantity": 1,
"line_price": 10000,
"extra_data": [
{
"type": "insurance",
"insured_amount": 900000,
"operator_name": "XXXXX",
"policy_number": "000 0000000/00000000",
"coverage_start_date": "2026-06-13T15:00:00Z",
"coverage_end_date": "2026-06-14T10:00:00Z"
}
]
}
}
}
}Marketplace
L'ensemble des données enrichies demandées ci-dessous permet d'identifier les transactions générées via une place de marché et ainsi mieux évaluer les risques par vendeurs et transactions. Dès lors que vous exercez une activité de place de marché, ces données sont requises.
Ces données doivent être précisées dans la variable payment.cart.items[].marketplace_seller[]
Si vous n'êtes pas toujours en mesure de fournir les données demandées ci-dessous au moment du paiement, des canaux de partage asynchrones sont envisageables: nos équipes techniques sont à disposition pour en parler.
Données générales
| Champ | Type | Description | Valeurs autorisées |
|---|---|---|---|
payment.cart.items[].marketplace_seller.account_id | string | ||
payment.cart.items[].marketplace_seller.account_created | datetime | ISO 8601 | |
payment.cart.items[].marketplace_seller.country | string | ISO 3166-1 alpha-2 | |
payment.cart.items[].marketplace_seller.website | string | URL valide | |
payment.cart.items[].marketplace_seller.rating | float | [0-5] | |
payment.cart.items[].marketplace_seller.tags | string[] | ||
payment.cart.items[].marketplace_seller.account_type | Voir ci-dessous | business ou individual |
Données vendeurs business
business| Champ | Type | Description | Valeurs autorisées |
|---|---|---|---|
payment.cart.items[].marketplace_seller.account_type | business | ||
payment.cart.items[].marketplace_seller.business.company_name | |||
payment.cart.items[].marketplace_seller.business.commercial_name | |||
payment.cart.items[].marketplace_seller.business.business_id_number | |||
payment.cart.items[].marketplace_seller.business.legal_form |
Données vendeurs individual
individual| Champ | Type | Description | Valeurs autorisées |
|---|---|---|---|
payment.cart.items[].marketplace_seller.account_type | individual | ||
payment.cart.items[].marketplace_seller.individual.full_name | string | ||
payment.cart.items[].marketplace_seller.individual.email | Email (string) |