Postes de paiementVersion bêta privée

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.

Contact to enable

Contact your sales representative or support to enable this private preview feature.

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

Cost savings for eligible commercial cards for IC+ users: By passing Payment Line Items, you can participate in the Level 2/Level 3 (L2/L3) program that major card networks administer. For eligible commercial cards, passing line item data can provide interchange fee savings.
Rapprochement simplifié : dans les cas où il n’y a pas d’économies, la transmission des données relatives aux postes individuels peut faciliter le rapprochement 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 de paiements lorsque les données des postes sont transmises.

Restrictions de fonctionnalités

Les postes de paiement sont soumis aux 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)	Pris en charge pour tous les paiements, quels que soient le secteur d’activité et la localisation du client	Pris en charge pour tous les paiements, quels que soient le secteur d’activité et la localisation du client
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 (maximum de 4 postes pour American Express)	Identique aux cartes	Identique aux cartes
Feature compatibility	Only auto and separate authorization and capture modes work with Payment Line Items. You can’t currently use flexible payment scenarios or decremental authorization for transactions where you’re passing in Payment Line Items.	Identique aux cartes	Identique aux cartes
Métadonnées spécifiques à un secteur d’activité	You can’t send line items alongside industry specific metadata (such as car rental/lodging, and airlines).	Identique aux cartes. Klarna prend en charge les métadonnées spécifiques au secteur d’activité grâce aux données supplémentaires sur les marchands.	Identique aux cartes
Surfaces	Only available for payments made through the PaymentIntents API.	Identique aux cartes	Identique aux cartes

Éligibilité des cartes aux taux L2/L3

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. Cependant, ces transactions ne sont pas éligibles pour les é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 éligibles au niveau II : Pour Mastercard : 5812, 3501-3999, 7011, 3351-3500, 7512, 7513, 7519, 3000-3299, 4511, 4112, 8398, 4468, 5541, 5542, 5499, 5983 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 éligibles au niveau III : 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
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 et 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, 9402	Sans objet

Exigences relatives aux champs

All the fields mentioned below are passed inside amount_details. Refer to Sample request (Level II data) to learn about passing data.

Champs pris en charge par les cartes bancaires

Version bêta privée

Two more fields [Commodity Code] and [Unit of Measure] aren’t yet available in private preview, but will become required for the Visa CEDP program (refer to Network Cost Updates for Feb 20, 2025).

Nom du champ	Type	Valeurs/restrictions	Description	Requis pour L2/L3	Champs obligatoires de l’API
payment_details[customer_reference]	chaîne	Ce champ n’est pas disponible pour les paiements autres que par carte.	L’entreprise ou l’organisation peut demander à certains clients de fournir ces informations. Si c’est le cas, renseignez cette valeur. Autrement, vous pouvez ignorer ce champ.
payment_details[order_reference]	chaîne	Ce champ n’est pas disponible pour les paiements autres que par carte. If automatic_payment_methods.enabled is set to `true`, you must set this field as Card is a default Payment Method.	Valeur unique attribuée par l’entreprise pour identifier la transaction.	✅ L2/L3
discount_amount	nombre	La valeur doit être > 0	Remise totale appliquée à la transaction.
shipping[to_postal_code]	chaîne	Longueur maximale : 10 caractères La valeur doit être composée de caractères alphanumériques	En cas d’expédition d’un bien physique, le code postal du lieu de destination.
shipping[from_postal_code]	chaîne	Longueur maximale : 10 caractères La valeur doit être composée de caractères alphanumériques	En cas d’expédition d’un bien physique, le code postal du lieu d’expédition.
shipping[amount]	nombre	La valeur doit être >= 0	En cas d’expédition d’un bien physique, les frais de livraison.
tax[total_tax_amount]	nombre	La valeur doit être >= 0	Montant total des taxes pour la transaction.	✅ L2
line_items[taxe][total_tax_amount]	nombre	La valeur doit être >= 0	Montant total des taxes pour un seul poste.	✅ L3
line_items[product_name]	chaîne	Longueur maximale : 100 caractères	Nom du produit du poste.	✅ L3	✅
line_items[product_code]	chaîne	Longueur maximale : 12 caractères	Code produit du poste, par exemple une unité de gestion des stocks.	✅ L3
line_items[unit_cost]	nombre	La valeur doit être >= 0	Coût unitaire du poste.	✅ L3	✅
line_items[quantité]	nombre	La valeur doit être > 0	Quantité de postes.	✅ L3	✅
line_items[discount_amount]	nombre	La valeur doit être > 0	Remise appliquée à ce poste.

Remarque

Les champs suivants s’excluent mutuellement. Seul un des deux peut être fourni dans une requête :

tax[total_tax_amount] ou line_items[tax][total_tax_amount]
discount_amount ou line_items[discount_amount]

Autres champs pris en charge par Klarna

Klarna prend en charge les champs ci-dessus pour les cartes, et en outre, prend également en charge :

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

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 ci-dessus pour les cartes, et en outre, prend également en charge :

Nom du champ	Type	Valeurs/restrictions	Description
line_items[pmo][paypal][description]	chaîne	127 caractères maximum	Description du poste.
line_items[pmo][paypal][catégorie]	énumération	digital_goods, physical_goods, donation	Type du poste.
line_items[pmo][paypal][sold_by]	chaîne	127 caractères maximum	ID du compte Stripe du compte connecté qui vend l’article.

Postes 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 II : taxe de vente facturée sur les transactions
Niveau III : détails au niveau du poste (code produit, quantité, coût unitaire, etc.)

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

Exemple de réponse

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

Confirmation du PaymentIntent

Capture du PaymentIntent

Capturez le PaymentIntent séparément après confirmation en transmettant manual_capture: true lors de la création ou de la confirmation du PaymentIntent, puis appelez l’endpoint Capture séparément.

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

Postes 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

Command Line
cURL
curl https://api.stripe.com/v1/payment_intents \
  -u "sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=4600 \
  -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[discount_amount]"=0 \
  -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[tax][total_tax_amount]"=500 \
  -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][quantity]"=1 \
  -d "amount_details[line_items][0][discount_amount]"=0 \
  -d "amount_details[line_items][0][tax][total_tax_amount]"=100 \
  --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][discount_amount]"=0 \
  -d "amount_details[line_items][1][tax][total_tax_amount]"=100 \
  --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

{
  id: "pi_3OoMm5BLxXjrKOiR3LRyi610",
  amount: 4600,
  currency: "usd"
  amount_details: {
    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
          },
          payment_method_options: {
            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
          },
          payment_method_options: {
            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"
}

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