Postes de paiementVersion bêta publique

Envoyez des métadonnées de transaction supplémentaires pour tous les types de moyens de paiement pris en charge afin de réaliser des économies, de faciliter le rapprochement des paiements et d’améliorer les taux d’autorisation.

Disponible avec l'en-tête d'aperçu

Vous pouvez utiliser cette fonctionnalité en version bêta publique en incluant l’en-tête de version 2025-04-30.preview ou une version ultérieure dans votre requête API.

Les postes de paiement sont une fonctionnalité de l’API Payment Intents qui présente des avantages pour le traitement des cartes et des moyens de paiement locaux.

Réduction des coûts pour les cartes commerciales admissibles des utilisateurs bénéficiant de la tarification IC+ : en transmettant les postes de paiement, vous pouvez participer au programme de niveau 2/niveau 3 (L2/L3) géré par les principaux réseaux de cartes. Pour les cartes commerciales admissibles, la transmission des données relatives aux postes de paiement peut permettre de réaliser des économies sur les frais d’interchange.
Rapprochement simplifié : la transmission des données relative aux postes peut également faciliter le rapprochement comptable pour vos clients. Par exemple, si vous servez principalement des clients gouvernementaux, ces données aideront le client à rapprocher ses achats de ce qui apparaît sur son relevé de compte.
Amélioration des taux d’autorisation : les moyens de paiement tels que PayPal et Klarna utilisent les données des postes dans leurs modèles de souscription, ce qui leur permet potentiellement d’approuver davantage d’options de paiement par crédit lorsque les données des postes sont transmises.

Restrictions de fonctionnalités

Les postes de paiement présentent les restrictions suivantes pour les types de moyens de paiement pris en charge :

	Programme L2/L3 pour les cartes	Klarna	PayPal
Disponibilité géographique	Uniquement pris en charge pour les transactions nationales aux États-Unis (utilisateur des États-Unis acceptant les cartes émises aux États-Unis, à l’exclusion des territoires américains)	Klarna est un moyen de paiement international. Pour obtenir de l’aide sur l’adresse de l’entreprise, consultez la page Paiements Klarna.	Disponible pour les clients dans tous les pays. Pour obtenir de l’aide sur l’adresse de l’entreprise, consultez la page Paiements PayPal.
Réseaux de cartes	Uniquement pris en charge pour Visa, Mastercard et American Express (les économies de coûts nécessitent un accord direct avec American Express)	Sans objet	Sans objet
Nombre de postes	Prend actuellement en charge 100 postes de facture. (La spécification American Express nous limite à l’envoi des 4 premiers postes.)	Identique aux cartes	Identique aux cartes
Compatibilité des fonctionnalités	Les modes capture automatique et capture manuelle fonctionnent tous deux avec les postes de paiement. À l’heure actuelle, vous ne pouvez pas utiliser les scénarios de paiement flexibles ou les diminutions d’autorisation avec des transactions pour lesquelles vous transmettez des postes de paiement.	Les modes capture automatique et capture manuelle fonctionnent tous deux avec les postes de paiement.	Les modes capture automatique et capture manuelle fonctionnent tous deux avec les postes de paiement.
Métadonnées spécifiques à un secteur d’activité	Vous ne pouvez pas envoyer de postes avec des métadonnées spécifiques à un secteur d’activité tels que la location de voitures/l’hébergement et les compagnies aériennes	Klarna prend en charge les métadonnées spécifiques à un secteur d’activité grâce aux données supplémentaires sur les marchands (version bêta privée).	Identique aux cartes
Pages	Disponible pour les paiements effectués via l’API PaymentIntents.	Identique aux cartes	Identique aux cartes

Éligibilité des cartes aux taux L2/L3

Programme Visa CEDP

Pour en savoir plus sur le lancement par Visa d’un nouveau programme appelé Programme commercial de données améliorées (CEDP) en remplacement de ses programmes d’interchange américains de niveau 2/3 existants, ainsi que sur les frais de réseau supplémentaires applicables, consultez les mises à jour des coûts de réseau du 20 février 2025.

Consultez la section Codes MCC par secteur d’activité pour connaître le MCC auquel appartient votre entreprise.

L’API Stripe ne rejette pas les postes qui ne répondent pas aux exigences MCC ou fiscales du réseau, mais ces transactions ne sont pas admissibles aux économies de niveau 2/3 correspondantes.

Éligibilité des cartes aux taux L2/L3	Niveau 2	Niveau 3
Types de cartes	Seules les cartes Business, Purchasing et Corporate sont éligibles	Seules les cartes Purchasing et Corporate sont éligibles
MCC	Les utilisateurs appartenant aux MCC suivants ne sont pas admissibles au niveau 2 : Pour Mastercard : 5812, 3501-3999, 7011, 3351-3500, 7512, 7513, 7519, 3000-3299, 4511, 4112 Pour Visa : 5812, 5814, 3501-4010, 3351-3500, 7512, 7513, 3000-3299, 4511, 4411, 4112, 4722, 5962, 5966 et 5967	Les utilisateurs appartenant aux MCC suivants ne sont pas admissibles au niveau 3 : Pour Mastercard : 5812, 3501-3999, 7011, 3351-3500, 7512, 7513, 7519, 3000-3299, 4511, 4112, 8398, 4468, 5499, 5541, 5542, 5983 Pour Visa : 5812, 5814, 3501-4010, 3351-3500, 7512, 7513, 3000-3299, 4511, 4411, 4112, 4722, 5962, 5966 et 5967
Exigences en matière de taxe sur les ventes	Pour Visa : la taxe sur les ventes doit être comprise entre 0,1 % et 22 %, sauf si l’entreprise appartient à l’un des MCC suivants : 4468, 5499, 5541, 5542 ou 5983 Pour Mastercard : la taxe sur les ventes doit être comprise entre 0,1 % et 30 %, sauf si l’entreprise appartient à l’un des MCC suivants : 4468, 5541, 5542, 5499, 5983, 7511, 9752, 4111, 4131, 4215, 4784, 8211, 8220, 8398, 8661, 9211, 9222, 9311, 9399 ou 9402	Sans objet
Exigences minimales pour les champs	tax[total_tax_amount] payment_details[order_reference]	line_item[product_name] line_item[unit_cost] line_item[quantity] line_item[tax][total_tax_amount] line_item[product_code] line_items[unit_of_measure] payment_details[order_reference]

Exigences relatives aux champs

Tous les champs mentionnés ci-dessous sont transmis dans les paramètres amount_details ou payment_details. Reportez-vous à l’exemple de requête (données de niveau 2) pour en savoir plus sur la transmission de données.

Champs généraux pris en charge

Nom du champ	Type	Description	Format
line_item[product_name]	chaîne	Nom du produit du poste.	Champ obligatoire Requis pour L3 Longueur maximale de 1 024 caractères (les cartes sont tronquées à 26 caractères et PayPal à 127 caractères)
line_item[unit_cost]	nombre entier	Coût unitaire du poste exprimé dans la plus petite unité monétaire	Champ obligatoire Requis pour L3 La valeur doit être >= 0
line_item[quantity]	nombre entier	Quantité de postes.	Champ obligatoire Requis pour L3 La valeur doit être > 0
line_item[tax][total_tax_amount]	nombre entier	Le montant total de la taxe sur un seul poste de facture exprimé dans la plus petite unité monétaire	Requis pour L3 La valeur doit être >= 0 Validation conditionnelle ¹
line_item[product_code]	chaîne	Code produit du poste, par exemple une unité de gestion des stocks.	Requis pour L3 Longueur maximale : 12 caractères
line_items[unit_of_measure]	chaîne	Unité de mesure du poste, par exemple gallons, pieds, mètres, etc.	Requis pour L3 Longueur maximale : 12 caractères Alphanumérique
payment_details[order_reference]	chaîne	Valeur unique attribuée par l’entreprise pour identifier la transaction.	Requis sous conditions ³ Requis pour L3 Requis pour L2 Avant d’envoyer cette chaîne à un réseau de cartes, nous la tronquons à 25 caractères alphanumériques, à l’exclusion des espaces
tax[total_tax_amount]	nombre entier	Le montant total des taxes sur la transaction représenté dans la plus petite unité monétaire	Requis pour L2 La valeur doit être >= 0 Validation conditionnelle ¹
payment_details[customer_reference]	chaîne	Une valeur unique permettant d’identifier le client. Ce champ est uniquement disponible pour les paiements par carte	Avant d’envoyer cette chaîne à un réseau de cartes, nous la tronquons à 25 caractères alphanumériques, à l’exclusion des espaces
shipping[to_postal_code]	chaîne	S’il s’agit de l’envoi d’une marchandise, le code postal de l’endroit où il est expédié	Longueur maximale de 10 caractères Alphanumérique
shipping[from_postal_code]	chaîne	S’il s’agit de l’envoi d’une marchandise, le code postal de l’endroit d’où il est expédié	Longueur maximale de 10 caractères Alphanumérique
shipping[amount]	nombre entier	S’il s’agit de l’envoi d’une marchandise, les frais de livraison sont exprimés dans la plus petite unité monétaire	La valeur doit être >= 0
discount_amount	nombre entier	La remise totale appliquée à la transaction exprimée dans la plus petite unité monétaire	La valeur doit être > 0 Validation conditionnelle ²
line_item[discount_amount]	nombre entier	La réduction appliquée à ce poste exprimée dans la plus petite unité monétaire	La valeur doit être > 0 Validation conditionnelle ²

¹ tax[total_tax_amount] et line_items[tax][total_tax_amount] s’excluent mutuellement. Vous pouvez uniquement spécifier l’un ou l’autre.

² discount_amount et line_items[discount_amount] s’excluent mutuellement. Vous pouvez uniquement spécifier l’un ou l’autre.

³ Le champ payment_details[order_reference] est requis lorsque le tableau Payment Method Types contient card, y compris lorsque automatic_payment_methods.enabled est défini sur true.

Champs pris en charge par d’autres cartes

Les cartes prennent en charge les champs généraux qui précèdent, ainsi que :

Nom du champ	Type	Description	Format
line_items[payment_method_options][carte][commodity_code]	chaîne	Identifiant qui catégorise les articles achetés à l’aide d’un système de produits normalisé, tel que (mais sans s’y limiter) : UNSPSC, NAICS, NAPCS, etc.	Longueur maximale de 12 caractères. Les valeurs doivent être constituées de caractères alphanumériques sans espaces.

Autres champs pris en charge par Klarna

Klarna prend en charge les champs généraux qui précèdent, ainsi que :

Nom du champ	Type	Description	Format
line_items[payment_method_options][klarna][product_url]	chaîne	URL http ou https valide du produit	Max 4096 caractères. Expression régulière : `https?:\/\/[-a-zA-Z0-9@:%._\+~#=]{1,256}\.[a-zA-Z0-9()]{1,64}\b([-a-zA-Z0-9()!@:%_\+.~#?&\/\/=]*)`
line_items[payment_method_options][klarna][image_url]	chaîne	URL http ou https valide de l’image	Max 4096 caractères. Expression régulière : `https?:\/\/[-a-zA-Z0-9@:%._\+~#=]{1,256}\.[a-zA-Z0-9()]{1,64}\b([-a-zA-Z0-9()!@:%_\+.~#?&\/\/=]*)`

Remarque

Pour les transactions Klarna, le montant total est implicitement dérivé de la formule (unit_cost * quantity) - discount_amount + tax.total_tax_amount. Aucun champ explicite ne permet de transmettre le montant.

Autres champs pris en charge par PayPal

PayPal prend en charge les champs généraux qui précèdent, ainsi que :

Nom du champ	Type	Description	Format
line_items[payment_method_options][paypal][description]	chaîne	Description du poste.	127 caractères maximum
line_items[payment_method_options][paypal][category]	énumération	Type du poste.	digital_goods, physical_goods, donation
line_items[payment_method_options][paypal][sold_by]	chaîne	ID du compte Stripe du compte connecté qui vend l’article. Laissez ce champ vide si vous n’êtes pas un compte connecté.	127 caractères maximum

Postes de facture spécifiques aux cartes pour les taux L2/L3

Transmettre les données requises pour les cartes éligibles aux programmes des réseaux L2/L3

Niveau 2 : taxe de vente facturée sur les transactions
Niveau 3 : détails au niveau du poste (code produit, quantité, coût unitaire, etc.)

Exemple de requête (données de niveau 2)

Exemple de réponse (données de niveau 2)

{
  id: "pi_3OoMm5BLxXjrKOiR3LRyi610",
  amount: 4600,
  currency: "usd"
  amount_details: {
    tax: {
      total_tax_amount: 500
    },
  },
  status: "requires_payment_method"
}

Opérations PaymentIntent

Vous pouvez transmettre des postes de facture lors de la confirmation et de la capture.

Définir des postes pendant la confirmation

Vous pouvez définir des postes de facture lors de la confirmation, quel que soit le capture_method choisi. Si vous transmettez des postes lors de la confirmation, puis que vous les capturez séparément, vous n’avez pas besoin de les transmettre à nouveau.

Définir des postes pendant la capture

Si vous ne spécifiez pas les postes lors de la confirmation, vous pouvez les transmettre lors de la capture.

Remarque

Non pris en charge lors de l’utilisation de PayPal

Transmettez un hachage amount_details mis à jour lors de la capture si nécessaire.

Postes de facture spécifiques au moyen de paiement

Transmettez d’autres types de moyens de paiement par poste de facture, le tout en un seul endroit. Vous pouvez également transmettre des données relatives aux moyens de paiement avec lesquels vous ne confirmez peut-être pas, à condition que le paramètre soit pris en charge. Ainsi, vous pouvez simplifier votre intégration et éviter les efforts de développement pour ajouter ou supprimer des champs spécifiques à chaque mode de paiement.

Remarque

Les postes ne sont pas inclus par défaut dans la réponse de l’API. Pour renvoyer des postes, développez amount_details.line_items

Exemple de requête (avec des postes spécifiques au moyen de paiement)

Command Line
cURL
curl https://api.stripe.com/v1/payment_intents \
  -u "sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=4000 \
  -d currency=usd \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=paypal \
  -d "payment_method_types[2]"=klarna \
  -d "payment_details[customer_reference]"=customer_reference \
  -d "payment_details[order_reference]"=order_reference \
  -d "amount_details[shipping][from_postal_code]"=94110 \
  -d "amount_details[shipping][to_postal_code]"=94117 \
  -d "amount_details[shipping][amount]"=100 \
  -d "amount_details[line_items][0][product_code]"=SKU001 \
  -d "amount_details[line_items][0][product_name]"="Product 001" \
  -d "amount_details[line_items][0][unit_cost]"=2000 \
  -d "amount_details[line_items][0][discount_amount]"=100 \
  -d "amount_details[line_items][0][quantity]"=1 \
  -d "amount_details[line_items][0][tax][total_tax_amount]"=100 \
  -d "amount_details[line_items][0][unit_of_measure]"=feet \
  -d "amount_details[line_items][0][payment_method_options][card][commodity_code]"=123123 \
  --data-urlencode "amount_details[line_items][0][payment_method_options][klarna][image_url]"="https://www.example.com/image.jpg" \
  --data-urlencode "amount_details[line_items][0][payment_method_options][klarna][product_url]"="https://www.example.com/product" \
  -d "amount_details[line_items][0][payment_method_options][paypal][description]"="This is a sample product description unique to PayPal for SKU001" \
  -d "amount_details[line_items][0][payment_method_options][paypal][category]"=digital_goods \
  -d "amount_details[line_items][1][product_code]"=SKU002 \
  -d "amount_details[line_items][1][product_name]"="Product 002" \
  -d "amount_details[line_items][1][unit_cost]"=1800 \
  -d "amount_details[line_items][1][quantity]"=1 \
  -d "amount_details[line_items][1][tax][total_tax_amount]"=100 \
  -d "amount_details[line_items][1][unit_of_measure]"=gallons \
  -d "amount_details[line_items][1][payment_method_options][card][commodity_code]"=123123 \
  --data-urlencode "amount_details[line_items][1][payment_method_options][klarna][image_url]"="https://www.example.com/image.jpg" \
  --data-urlencode "amount_details[line_items][1][payment_method_options][klarna][product_url]"="https://www.example.com/product" \
  -d "amount_details[line_items][1][payment_method_options][paypal][description]"="This is a sample product description unique to PayPal for SKU002" \
  -d "amount_details[line_items][1][payment_method_options][paypal][category]"=physical_goods \
  -d "expand[0]"="amount_details.line_items"

Exemple de réponse (avec des postes spécifiques au moyen de paiement)

{
  id: "pi_3OoMm5BLxXjrKOiR3LRyi610",
  amount: 4600,
  currency: "usd"
  amount_details: {
    discount_amount: 100,
    shipping: {
      from_postal_code: "94110",
      to_postal_code: "94117",
      amount: 100
    },
    tax: {
      total_tax_amount: 500
    },
    line_items: {
      object: "list",
      url: "/v1/payment_intents/pi_3OoMm5BLxXjrKOiR3LRyi610/amount_details_line_items",
      has_more: false,
      data: [{
          _id: "li_123",
          product_code: "SKU001",
          product_name: "Product 001",
          unit_cost: 2000,
          quantity: 1,
          discount_amount: 0,
          tax: {
            total_tax_amount: 100
          },
          unit_of_measure: "feet",
          payment_method_options: {
            card: {
              commodity_code: "123123",
            },
            klarna: {
              image_url: "https://www.example.com/image.jpg",
              product_url: "https://www.example.com/product"
            },
            paypal: {
              description: "This is a sample product description unique to PayPal for SKU001",
              category: digital_goods,
            }
          }
        },
        {
          _id: "li_456",
          product_code: "SKU002",
          product_name: "Product 002",
          unit_cost: 1800,
          quantity: 1,
          discount_amount: 0,
          tax: {
            total_tax_amount: 100
          },
          unit_of_measure: "gallons",
          payment_method_options: {
            card: {
              commodity_code: "123123",
            },
            klarna: {
              image_url: "https://www.example.com/image.jpg",
              product_url: "https://www.example.com/product"
            },
            paypal: {
              description: "This is a sample product description unique to PayPal for SKU001",
              category: physical_goods,
            }
          }
        }
      ]
    }
  },
  status: "requires_payment_method"
}

Utilisation de la réduction et/ou de la taxe de niveau supérieur

L’exemple suivant montre la transmission des attributs discount_amount et tax de niveau supérieur, sans attributs tax et discount_amount au niveau des postes de facture

Exemple de requête (remise et/ou taxe de haut niveau)

Exemple de réponse (remise et/ou taxe de premier niveau)

{
  "id": "pi_3R0p2JCvDOElLqwO0mlHFrzv",
  "object": "payment_intent",
  "amount": 2500,
  "amount_capturable": 0,
  "amount_details": {
    "discount_amount": 100,
    "line_items": {
      "object": "list",
      "data": [
        {
          "id": "uli_RueKif6jOR65uG",
          "object": "amount_details_line_item",
          "discount_amount": null,
          "payment_method_options": {
            "klarna": {
              "image_url": "https://www.example.com/image.jpg",
              "product_url": "https://www.example.com/product"
            },
            "paypal": {
              "category": "digital_goods",
              "description": "This is a sample product description unique to PayPal for SKU001"
            }
          },
          "product_code": "SKU001",
          "product_name": "Product 001",
          "quantity": 1,
          "tax": null,
          "unit_cost": 2000
        }
      ],
      "has_more": false,
      "url": "/v1/payment_intents/pi_3R0p2JCvDOElLqwO0mlHFrzv/amount_details_line_items"
    },
    "shipping": {
      "amount": 100,
      "from_postal_code": "94110",
      "to_postal_code": "94117"
    },
    "tax": {
      "total_tax_amount": 500
    },
    "tip": {}
  },
  "amount_received": 0,
  "amount_subtotal": 2500,
  "capture_method": "automatic_async",
  "payment_details": {
    "customer_reference": "customer_reference",
    "order_reference": "order_reference"
  },
  "payment_method": null,
  "payment_method_configuration_details": null,
  "payment_method_options": {
    "card": {
      "installments": null,
      "mandate_options": null,
      "network": null,
      "request_three_d_secure": "automatic"
    },
    "klarna": {
      "preferred_locale": null
    },
    "paypal": {
      "preferred_locale": null,
      "reference": null
    }
  },
  "payment_method_types": ["card", "paypal", "klarna"],
  ...
}

Codes MCC par secteur d’activité

Catégorie	Description
Produits alimentaires et boissons	5812 : restaurants (hors restauration rapide) 5814 : restaurants de fast-food
hôtellerie et voyages	3000-3299 : compagnies aériennes 3501-3999, 7011 : hôtels et hébergement 3351-3500 : agences de location de voitures 4722 : agences de voyages et opérateurs touristiques 7512 : agence de location automobile 7513 : location et crédit-bail de camions 7519 : location de camping-cars et de véhicules de loisirs 4411 : bateaux de croisière 4112 : lignes ferroviaires de passagers 4111 : services de transport en commun locaux et suburbains 4215 : livraison de courrier et colis 4784 : Péages routiers et de pont 4468 : marinas, services maritimes 5983 : marchands de carburant
Vente au détail et e-commerce	5962 : marketing direct – Voyage 5966 : marketing direct – Télémarketing sortant 5967 : marketing direct – Autre
Services publics et divers	8398 : organismes caritatifs et d’assistance sociale 9752 : stations-service du Royaume-Uni, système de contrôle pour la sécurité des transactions 9211 : frais de justice, y compris pension alimentaire 9311 : paiement d’impôts 9222 : amendes 9402 : services postaux – réservés aux administrations publiques et autres services similaires 9399 : services publics (qui ne rentrent pas dans les autres catégories) et autres services similaires 8661 : organismes religieux 8211 : écoles et établissements d’enseignement 8220 : collèges, universités