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`

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`

Champ	Type	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`)