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.

Contactez pour activer

Contactez votre représentant commercial ou l’équipe Support pour activer cette fonctionnalité en version bêta privée

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.

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é : 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 (maximum de 4 postes pour American Express)	Identique aux cartes	Identique aux cartes
Compatibilité des fonctionnalités	Seuls les modes d’autorisation et de capture automatiques et distincts fonctionnent avec les postes de paiement. À l’heure actuelle, vous ne pouvez pas utiliser les diminutions d’autorisation pour des transactions pour lesquelles vous transmettez des postes de paiement.	Seuls les modes d’autorisation et de capture automatiques et distincts fonctionnent avec les postes de paiement.	Seuls les modes d’autorisation et de capture automatiques et distincts fonctionnent 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	Cette option s’applique uniquement aux paiements effectués via l’API PaymentIntents.	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

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

Champs généraux pris en charge

Version bêta privée

Deux autres champs [Code marchandise] et [Unité de mesure] ne sont pas encore disponibles en version bêta privée, mais deviendront obligatoires pour le programme Visa CEDP (reportez-vous aux mises à jour des coûts de réseau du 20 février 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 disponible que pour les paiements par carte. Avant d’envoyer cette chaîne à un réseau de cartes, nous la réduisons à 25 caractères alphanumériques, espaces non compris.	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 disponible que pour les paiements par carte. Avant d’envoyer cette chaîne à un réseau de cartes, nous la réduisons à 25 caractères alphanumériques, espaces non compris. Si automatic_payment_methods.enabled est défini sur `true`, vous devez définir ce champ, car Carte est un moyen de paiement par défaut.	Valeur unique attribuée par l’entreprise pour identifier la transaction.	✅ L2/L3
discount_amount	nombre entier	La valeur doit être > 0	Réduction totale appliquée à cette transaction représentée dans la plus petite unité monétaire.
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 entier	La valeur doit être >= 0	S’il s’agit d’une marchandise physique, le coût de livraison est exprimé dans la plus petite unité monétaire.
tax[total_tax_amount]	nombre entier	La valeur doit être >= 0	Montant total des taxes pour la transaction.	✅ L2
line_items[taxe][total_tax_amount]	nombre entier	La valeur doit être >= 0	Montant total de la taxe sur un seul poste de facture représenté dans la plus petite unité monétaire.	✅ L3
line_items[product_name]	chaîne	Longueur maximale de 1024 caractères. Les cartes sont tronquées à 26 caractères et PayPal à 127 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 entier	La valeur doit être >= 0	Coût unitaire du poste représenté dans la plus petite unité monétaire.	✅ L3	✅
line_items[quantité]	nombre entier	La valeur doit être > 0	Quantité de postes.	✅ L3	✅
line_items[discount_amount]	nombre entier	La valeur doit être > 0	Réduction appliquée à ce poste représentée dans la plus petite unité monétaire.

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[payment_method_options][klarna][product_url]	chaîne	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()!@:%_\+.~#?&\/\/=]*)`	URL http ou https valide du produit
line_items[payment_method_options][klarna][image_url]	chaîne	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()!@:%_\+.~#?&\/\/=]*)`	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[payment_method_options][paypal][description]	chaîne	127 caractères maximum	Description du poste.
line_items[payment_method_options][paypal][category]	énumération	digital_goods, physical_goods, donation	Type du poste.
line_items[payment_method_options][paypal][sold_by]	chaîne	127 caractères maximum	ID du compte Stripe du compte connecté qui vend l’article.

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 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 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

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 \
  --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 \
  --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: {
    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
          },
          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"
}

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 réponse

{
  "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