Métadonnées du secteurVersion bêta publique

Découvrez comment fournir des données spécifiques aux achats liés aux voyages et aux loisirs.

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

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

Les métadonnées sectorielles sont une fonctionnalité de l’API Payment Intents qui vous permet de fournir des données obligatoires propres à votre secteur pour les transactions dans les industries du voyage et du divertissement prises en charge.

La fourniture de données spécifiques à un secteur est obligatoire pour certains codes de catégorie de commerçant afin de se conformer aux exigences des réseaux de cartes et peut améliorer les taux d’autorisation et l’évaluation des risques pour les transactions Klarna.

Mettez en œuvre les métadonnées du secteur pour les paiements par carte si votre entreprise opère sous des codes de catégorie marchande (MCC) spécifiques aux voyages et aux divertissements, tels que les codes de location de voitures, d’hébergement, d’agences de voyage ou de compagnies aériennes répertoriés dans le champ disponibilité).

Disponibilité

La transmission de données spécifiques à un secteur n’est disponible que pour les utilisateurs de PaymentIntents et est limitée aux codes de catégorie de commerçant (MCC) suivants.

Car Rental : 3351-3441, 7512, 7513, 7519
Hébergement : 3501-3999, 7011
Agence de voyage : 4722
Vol : 4511

Vous pouvez soumettre des métadonnées sectorielles pour les paiements effectués avec certaines marques de cartes (Visa, Mastercard, Amex et Discover) ainsi qu’avec Klarna.

Les secteurs verticaux propres à Klarna

En plus de la location de voitures, de l’hébergement et des vols, Klarna apporte son assistance à des secteurs verticaux supplémentaires qui ne sont pas disponibles pour les paiements par carte bancaire, notamment :

Événements (concerts, festivals, sports, conférences)
Assurance (polices d’assurance autonomes)
Transport par train, autobus et ferry
Voyages et visites organisés
Coupons
Commerçants sur marketplace

Pour en savoir plus sur ces secteurs verticaux exceptionnels de Klarna, consultez la documentation sur les données d’achat supplémentaires de Klarna.

Version bêta privée pour les cartes

Les métadonnées sectorielles sont en version bêta privée pour les transactions par carte bancaire et en version bêta publique uniquement pour Klarna. De plus, les transactions par carte ne prennent pas en charge le transfert des données de croisière.

Envoyer des données spécifiques à votre secteur d’activité

Vous envoyez des données spécifiques au secteur par l’intermédiaire du paramètre payment_details lorsque vous créez, mettez à jour, ou confirmez une PaymentIntent.

Le hachage payment_details contient un tableau de hachages pour chaque secteur vertical : car_rental_data, lodging_data et flight_data.

Chaque hachage dans ces tableaux représente une location de voiture, un séjour dans un hébergement ou un billet d’avion individuel.

Pour en savoir plus sur la transmission des données, reportez-vous à la section Créer une PaymentIntent.

Comportement de traitement des tableaux

Les moyens de paiement gèrent différemment plusieurs réservations :

Cartes : seule la première entrée de chaque tableau (car_rental_data[0], lodging_data[0], flight_data[0]) est envoyée aux réseaux de cartes. Les entrées supplémentaires sont ignorées et ne sont pas utilisées pour la conformité des réseaux de cartes.
Klarna : toutes les entrées de chaque tableau sont traitées et utilisées dans les décisions d’évaluation des risques et d’autorisation de Klarna.

Pour les transactions par carte comportant plusieurs réservations (telles que plusieurs séjours à l’hôtel ou locations de voiture), créez des PaymentIntents distincts pour chaque réservation afin de vous assurer que toutes les données de transaction sont correctement envoyées aux réseaux de cartes.

Cette section est organisée en trois catégories de propriétés pour chaque secteur :

Propriétés générales prises en charge : champs de base pris en charge par tous les moyens de paiement. Ces champs définissent la structure API principale.
Propriétés supplémentaires prises en charge pour les cartes : champs supplémentaires utilisés par les réseaux de cartes en plus des propriétés générales. Lors du traitement des paiements par carte, utilisez les champs des catégories « Général » et « Cartes ».
Propriétés supplémentaires prises en charge pour Klarna : champs supplémentaires utilisés par Klarna en plus des propriétés générales. Lors du traitement des paiements Klarna, utilisez les champs des sections « Général » et « Klarna ».

Cards et Klarna utilisent des propriétés et des règles de validation différentes. Les propriétés envoyées à un moyen de paiement qui ne sont pas prises en charge sont ignorées.

Les onglets suivants décrivent les hachages car_rental_data, lodging_data, et flight_data :

Propriétés générales prises en charge

L’API Stripe prend en charge les propriétés suivantes, utilisées par toutes les transactions par carte et Klarna.

Remarque

Les champs listés ci-dessous sont imbriqués sous payment_details.car_rental_data. Pour savoir comment structurer votre requête API, consultez l’exemple de code complet.

Champs obligatoires pour la location de voitures

Voici les champs minimum requis pour toutes les transactions de location de voitures :

pickup.address.line1
pickup.address.city
pickup.address.postal_code
pickup.address.country
pickup.time
drop_off.address.line1
drop_off.address.city
drop_off.address.postal_code
drop_off.address.country
drop_off.time
total.amount

Voici des champs supplémentaires obligatoires pour les transactions par carte :

pickup.address.state (lorsque cela s’applique au pays)
drop_off.address.state (lorsque cela s’applique au pays)
booking_number
days_rented
customer_service_phone_number
renter_name
vehicle.type
vehicle.make
vehicle.model

Nom de la propriété	Type	Description	Format
`pickup.address.line1`	Chaîne	Première ligne de l’adresse de prise en charge de la voiture (rue, boîte postale ou nom de l’entreprise)	Propriété requise Alphanumérique Longueur maximale : 99 caractères
`pickup.address.postal_code`	Chaîne	Code postal de l’adresse de prise en charge de la voiture	Propriété requise Alphanumérique Longueur maximale : 10 caractères
`pickup.address.city`	Chaîne	Ville, quartier, banlieue, commune ou village de l’adresse de prise en charge de la voiture	Propriété requise Alphanumérique Longueur maximale : 99 caractères
`pickup.address.country`	Chaîne	Code pays de l’adresse de prise en charge de la voiture	Propriété requise Doit être un code pays ISO 3166-1 alpha-2 valide
`pickup.time`	Horodatage	Heure de prise en charge de la voiture	Propriété requise Secondes écoulées depuis de début de l’ère Unix La date doit être comprise entre il y a 2 ans et d’ici 2 ans.
`drop_off.address.line1`	Chaîne	Première ligne de l’adresse de restitution de la voiture (rue, boîte postale ou nom de l’entreprise)	Propriété requise Alphanumérique Longueur maximale : 99 caractères
`drop_off.address.postal_code`	Chaîne	Code postal de l’adresse de restitution de la voiture	Propriété requise Alphanumérique Longueur maximale : 10 caractères
`drop_off.address.city`	Chaîne	Ville, quartier, banlieue, commune ou village de l’adresse de restitution de la voiture	Propriété requise Alphanumérique Longueur maximale : 99 caractères
`drop_off.address.country`	Chaîne	Code pays de l’adresse de restitution de la voiture	Propriété requise Doit être un code pays ISO 3166-1 alpha-2 valide
`drop_off.time`	Horodatage	Heure de restitution de la voiture	Propriété requise Secondes écoulées depuis de début de l’ère Unix La date doit être comprise entre il y a 2 ans et d’ici 2 ans.
`total.amount`	Nombre entier	Prix total de la location de la voiture dans la plus petite unité monétaire	Propriété requise Minimum : 0
`pickup.address.state`	Chaîne	État, comté, province ou région de l’adresse de prise en charge de la voiture	Requis pour les cartes Validation sous certaines conditions¹ Alphanumérique Longueur maximale : 99 caractères
`drop_off.address.state`	Chaîne	État, comté, province ou région de l’adresse de restitution de la voiture	Requis pour les cartes Validation sous condition² Alphanumérique Longueur maximale : 99 caractères
`pickup.address.line2`	Chaîne	Deuxième ligne de l’adresse de prise en charge de la voiture (rue, boîte postale ou nom de l’entreprise)	Alphanumérique Longueur maximale : 99 caractères
`drop_off.address.line2`	Chaîne	Deuxième ligne de l’adresse de restitution de la voiture (rue, boîte postale ou nom de l’entreprise)	Alphanumérique Longueur maximale : 99 caractères
`carrier_name`	Chaîne	Nom de la société de location de voitures	Alphanumérique Longueur maximale : 255 caractères
`vehicle.vehicle_class`	Chaîne	Catégorie du véhicule loué	Une des options suivantes `economy`, `premium_economy`, `business`, ou `first_class`
`affiliate.name`	Chaîne	Nom de l’affilié à l’origine de l’achat	Alphanumérique Longueur maximale : 255 caractères

¹ pickup.address.state doit être un état valide dans pickup.address.country pour les transactions par carte

² drop_off.address.state doit être un état valide dans drop_off.address.country pour les transactions par carte

Propriétés supplémentaires prises en charge pour les cartes

Les cartes prennent en charge les propriétés générales prévues et utilisent également les propriétés suivantes. Klarna ne verra pas ces propriétés, et elles n’amélioreront pas les taux d’autorisation ou l’évaluation du risque pour les transactions Klarna.

Nom de la propriété	Type	Description	Format
`booking_number`	Chaîne	Numéro de confirmation de la réservation pour la location de la voiture	Requis pour les cartes Alphanumérique Longueur maximale : 255 caractères
`days_rented`	Nombre entier	Nombre de jours de location de la voiture	Requis pour les cartes Minimum : 1 Maximum : 999
`customer_service_phone_number`	Chaîne	Numéro de téléphone du service client de la société de location de voitures	Requis pour les cartes Doit être un numéro de téléphone valide (chiffres uniquement), peut également être composé de zéros (`0000000000`) en mode test. Les numéros de téléphone des pays autres que les États-Unis doivent commencer par un symbole plus (`+`).
`renter_name`	Chaîne	Nom de la personne qui loue le véhicule	Requis pour les cartes Longueur maximale : 198 caractères
`vehicle.type`	Chaîne	Code indiquant la classe du véhicule	Requis pour les cartes Une des options suivantes `mini`, `subcompact`, `economy`, `compact`, `midsize`, `intermediate`, `standard`, `full_size`, `luxury`, `premium`, `minivan`, `twelve_passenger_van`, `moving_van`, `fifteen_passenger_van`, `cargo_van`, `twelve_foot_truck`, `twenty_foot_truck`, `twenty_four_foot_truck`, `twenty_six_foot_truck`, `moped`, `stretch`, `regular`, `unique`, `exotic`, `small_medium_truck`, `large_truck`, `small_suv`, `medium_suv`, `large_suv`, `exotic_suv`, `four_wheel_drive`, `special`, `taxi`, ou `miscellaneous`
`vehicle.make`	Chaîne	Marque de la voiture louée	Requis pour les cartes Alphanumérique Longueur maximale : 40 caractères
`vehicle.model`	Chaîne	Modèle de la voiture louée	Requis pour les cartes Alphanumérique Longueur maximale : 40 caractères
`distance.amount`	Nombre entier	Distance parcourue pendant la période de location de la voiture	Propriété requise sous certaines conditions¹ Minimum : 0
`distance.unit`	Chaîne	Unité de distance pour la distance parcourue	Propriété requise sous certaines conditions¹ L’une des unités`miles` ou `kilometers`
`no_show_indicator`	Booléen	Indique si le client ne s’est pas présenté pour sa réservation	`true` (vrai) ou `false` (faux)
`pickup.location_name`	Chaîne	Lieu de prise en charge de la voiture de location	Alphanumérique Longueur maximale : 38 caractères
`drop_off.location_name`	Chaîne	Emplacement où la voiture de location a été restituée	Alphanumérique Longueur maximale : 38 caractères
`drivers[].driver_identification_number`	Chaîne	Numéro de permis de conduire ou d’identité du conducteur autorisé dans le contrat de location de la voiture	Alphanumérique Longueur maximale : 20 caractères Ces informations personnelles identifiables ne sont pas obligatoires.
`drivers[].driver_tax_number`	Chaîne	Numéro fiscal du conducteur autorisé dans le contrat de location de la voiture	Alphanumérique Longueur maximale : 20 caractères Ces informations personnelles identifiables ne sont pas obligatoires.
`total.rate_per_unit`	Nombre entier	Tarif facturé pour chaque unité de distance ou de temps parcourue	Minimum : 0
`total.rate_unit`	Chaîne	Unité utilisée pour calculer le tarif par unité parcourue	Une des options suivantes `miles`, `kilometers`, `days`, `weeks`, ou `months`
`total.tax.tax_exempt_indicator`	Booléen	Indique si la location de la voiture était exonérée de taxe ou si la taxe n’a pas été encaissée.	`true` (vrai) ou `false` (faux)
`total.tax.taxes[].rate`	Nombre entier	Pourcentage utilisé pour calculer ce montant de la taxe	Minimum : 0
`total.tax.taxes[].amount`	Nombre entier	Montant de cette taxe facturée pour la location de la voiture	Minimum : 0
`total.tax.taxes[].type`	Chaîne	Type de taxe appliqué à la location de la voiture	Alphanumérique Longueur maximale : 40 caractères
`total.extra_charges[].amount`	Nombre entier	Montants débités pendant la location de la voiture	Minimum : 0
`total.extra_charges[].type`	Chaîne	Types de suppléments facturés pendant la location de la voiture	L’une des options suivantes : `one_way_drop_off`, `regular_mileage`, `extra_mileage`, `late_charge`, `parking`, `towing`, `gps`, `phone`, `gas` ou `other`
`total.discounts.maximum_free_miles_or_kilometers`	Nombre entier	Nombre de miles ou de kilomètres gratuits autorisés pendant la location de la voiture	Minimum : 0 Maximum : 9999
`total.discounts.corporate_client_code`	Chaîne	Code attribué à une entreprise, utilisé pour les tarifs ou les remises accordés aux entreprises.	Alphanumérique Longueur maximale : 20 caractères
`total.discounts.coupon`	Chaîne	Code promotionnel utilisé pour réduire le tarif du contrat de location de la voiture.	Longueur maximale : 25 caractères
`vehicle.vehicle_identification_number`	Chaîne	Numéro d’immatriculation du véhicule loué	Alphanumérique Longueur maximale : 20 caractères
`vehicle.odometer`	Nombre entier	Relevé du compteur kilométrique lors de la première location de la voiture	Minimum : 0
`affiliate.code`	Chaîne	Code de l’affilié à l’origine de l’achat	Alphanumérique Longueur maximale : 20 caractères

¹ La propriété distance est facultative. Les sous-propriétés distance.amount et distance.unit sont requises si la distance est fournie.

Propriétés supplémentaires prises en charge par Klarna

Klarna prend en charge les propriétés générales prévues, ainsi que les propriétés suivantes. Les réseaux de cartes n’auront pas accès à ces propriétés et elles n’affecteront pas la conformité aux exigences des réseaux de cartes pour les transactions par carte.

Nom de la propriété	Type	Description	Format
`drivers[].name`	Chaîne	Nom complet du conducteur autorisé dans le contrat de location de la voiture	Obligatoire sous certaines conditions¹ Alphanumérique Longueur maximale : 198 caractères
`drivers[].date_of_birth.day`	Nombre entier	Date de naissance du conducteur autorisé dans le contrat de location de la voiture.	Exigence conditionnelle² Minimum : 1 Maximum : 31 La `date_of_birth` doit correspondre à une date valide dans le passé
`drivers[].date_of_birth.month`	Nombre entier	Date de naissance du conducteur autorisé dans le contrat de location de la voiture.	Exigence conditionnelle² Minimum : 1 Maximum : 12 La `date_of_birth` doit correspondre à une date valide dans le passé
`drivers[].date_of_birth.year`	Nombre entier	Date de naissance du conducteur autorisé dans le contrat de location de la voiture.	Exigence conditionnelle² Minimum : 1901 La `date_of_birth` doit correspondre à une date valide dans le passé
`carrier_name`	Chaîne	Nom de la société de location de voitures	Alphanumérique Longueur maximale : 255 caractères
`total.currency`	Chaîne	Devise du prix total de la location de la voiture	Doit être un code ISO 4217 à 3 lettres valide
`insurances[].insurance_type`	Chaîne	Type de couverture d’assurance fournie pour la location de la voiture	Exigence conditionnelle³ Une des options suivantes : `liability_supplement`, `loss_damage_waiver`, `partial_damage_waiver`, `personal_accident`, `personal_effects` ou `other`
`insurances[].amount`	Nombre entier	Prix de l’assurance fournie pour la location de la voiture dans la plus petite unité monétaire.	Exigence conditionnelle³ Minimum : 0
`insurances[].currency`	Chaîne	Devise de l’assurance fournie pour la location de la voiture	Doit être un code ISO 4217 à 3 lettres valide
`insurances[].insurance_company_name`	Chaîne	Nom de l’entreprise qui fournit l’assurance pour la location de la voiture	Longueur maximale : 255 caractères

¹ Le tableau des drivers est facultatif. Le paramètre drivers[].name est requis pour chaque pilote fourni.

² La propriété drivers[].date_of_birth est facultative. Les paramètres drivers[].date_of_birth.day, drivers[].date_of_birth.month et drivers[].date_of_birth.year sont requis si drivers[].date_of_birth est fourni.

³ Le tableau des insurances est facultatif. Les paramètres insurances[].insurance_type et insurances[].amount sont requis pour chaque assurance fournie.

Remarque

Pour certaines propriétés, les longueurs peuvent être tronquées afin de respecter les exigences de divers moyens de paiement acceptant des tailles de propriétés différentes.

Utiliser PaymentIntents

Incluez les données payment_details lorsque vous créez, mettez à jour, confirmez ou capturez une PaymentIntent.

Les étapes ci-dessous illustrent la confirmation et capture manuelles et montrent l’évolution des données payment_details tout au long du cycle de vie du PaymentIntent. Vous pouvez fournir des données payment_details pour les cas d’usage de confirmation automatique ou de capture automatique.

Créer un PaymentIntent

Créez une PaymentIntent non confirmée et non capturée avec le paramètre payment_details. Utilisez la méthode de mise à jour pour mettre à jour le paramètre payment_details avant de confirmer la PaymentIntent. Toutes les mises à jour du paramètre payment_details constituent un remplacement complet du hachage et doivent être valides pour votre mode de paiement.

Command Line
Sélectionner une languecURL
 No results
curl https://api.stripe.com/v1/payment_intents \
  -u "sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=200 \
  -d currency=usd \
  -d "payment_method_types[0]"=card \
  -d "payment_details[car_rental_data][0][booking_number]"=BOOK123456 \
  -d "payment_details[car_rental_data][0][days_rented]"=3 \
  --data-urlencode "payment_details[car_rental_data][0][customer_service_phone_number]"="+18005551234" \
  -d "payment_details[car_rental_data][0][renter_name]"="John Doe" \
  -d "payment_details[car_rental_data][0][no_show_indicator]"=false \
  -d "payment_details[car_rental_data][0][distance][amount]"=150 \
  -d "payment_details[car_rental_data][0][distance][unit]"=miles \
  -d "payment_details[car_rental_data][0][drivers][0][name]"="Jane Driver" \
  -d "payment_details[car_rental_data][0][drivers][0][driver_identification_number]"=D12345678 \
  -d "payment_details[car_rental_data][0][drivers][0][driver_tax_number]"=TN123456789 \
  -d "payment_details[car_rental_data][0][pickup][address][line1]"="123 Main St" \
  -d "payment_details[car_rental_data][0][pickup][address][postal_code]"=10001 \
  -d "payment_details[car_rental_data][0][pickup][address][city]"="New York" \
  -d "payment_details[car_rental_data][0][pickup][address][country]"=US \
  -d "payment_details[car_rental_data][0][pickup][address][state]"=NY \
  -d "payment_details[car_rental_data][0][pickup][address][line2]"="Apt 4B" \
  -d "payment_details[car_rental_data][0][pickup][time]"=1768500000 \
  -d "payment_details[car_rental_data][0][pickup][location_name]"="Downtown Garage" \
  -d "payment_details[car_rental_data][0][drop_off][address][line1]"="456 Elm St" \
  -d "payment_details[car_rental_data][0][drop_off][address][postal_code]"=02101 \
  -d "payment_details[car_rental_data][0][drop_off][address][city]"=Boston \
  -d "payment_details[car_rental_data][0][drop_off][address][country]"=US \
  -d "payment_details[car_rental_data][0][drop_off][address][state]"=MA \
  -d "payment_details[car_rental_data][0][drop_off][address][line2]"="Suite 101" \
  -d "payment_details[car_rental_data][0][drop_off][time]"=1768777200 \
  -d "payment_details[car_rental_data][0][drop_off][location_name]"="Airport Terminal" \
  -d "payment_details[car_rental_data][0][total][amount]"=30000 \
  -d "payment_details[car_rental_data][0][total][rate_per_unit]"=1500 \
  -d "payment_details[car_rental_data][0][total][rate_unit]"=days \
  -d "payment_details[car_rental_data][0][total][tax][tax_exempt_indicator]"=false \
  -d "payment_details[car_rental_data][0][total][tax][taxes][0][rate]"=10 \
  -d "payment_details[car_rental_data][0][total][tax][taxes][0][amount]"=3000 \
  -d "payment_details[car_rental_data][0][total][tax][taxes][0][type]"="Sales Tax" \
  -d "payment_details[car_rental_data][0][total][extra_charges][0][amount]"=2000 \
  -d "payment_details[car_rental_data][0][total][extra_charges][0][type]"=gps \
  -d "payment_details[car_rental_data][0][total][discounts][maximum_free_miles_or_kilometers]"=100 \
  -d "payment_details[car_rental_data][0][total][discounts][corporate_client_code]"=CORP123 \
  -d "payment_details[car_rental_data][0][total][discounts][coupon]"=SAVE20 \
  -d "payment_details[car_rental_data][0][insurances][0][insurance_type]"=liability_supplement \
  -d "payment_details[car_rental_data][0][insurances][0][amount]"=1500 \
  -d "payment_details[car_rental_data][0][vehicle][vehicle_class]"=premium_economy \
  -d "payment_details[car_rental_data][0][vehicle][type]"=compact \
  -d "payment_details[car_rental_data][0][vehicle][make]"=Toyota \
  -d "payment_details[car_rental_data][0][vehicle][model]"=Camry \
  -d "payment_details[car_rental_data][0][vehicle][vehicle_identification_number]"=1HGBH41JXMN109186 \
  -d "payment_details[car_rental_data][0][vehicle][odometer]"=25000 \
  -d "payment_details[car_rental_data][0][affiliate][name]"="Travel Partner" \
  -d "payment_details[car_rental_data][0][affiliate][code]"=TP001

Confirmer un PaymentIntent

Vous pouvez mettre à jour les payment_details lors de la confirmation de la PaymentIntent. Toutes les mises à jour de payment_details sont un remplacement de hachage complet et doivent être valides pour votre moyen de paiement. Pour en savoir plus sur ce que représente chaque propriété, consultez la page envoi de données spécifiques au secteur.

Command Line
Sélectionner une languecURL
 No results
curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/confirm \
  -u "sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "payment_details[car_rental_data][0][booking_number]"=BOOK123456 \
  -d "payment_details[car_rental_data][0][days_rented]"=3 \
  --data-urlencode "payment_details[car_rental_data][0][customer_service_phone_number]"="+18005551234" \
  -d "payment_details[car_rental_data][0][renter_name]"="John Doe" \
  -d "payment_details[car_rental_data][0][no_show_indicator]"=false \
  -d "payment_details[car_rental_data][0][distance][amount]"=150 \
  -d "payment_details[car_rental_data][0][distance][unit]"=miles \
  -d "payment_details[car_rental_data][0][drivers][0][name]"="Jane Driver" \
  -d "payment_details[car_rental_data][0][drivers][0][driver_identification_number]"=D12345678 \
  -d "payment_details[car_rental_data][0][drivers][0][driver_tax_number]"=TN123456789 \
  -d "payment_details[car_rental_data][0][pickup][address][line1]"="123 Main St" \
  -d "payment_details[car_rental_data][0][pickup][address][postal_code]"=10001 \
  -d "payment_details[car_rental_data][0][pickup][address][city]"="New York" \
  -d "payment_details[car_rental_data][0][pickup][address][country]"=US \
  -d "payment_details[car_rental_data][0][pickup][address][state]"=NY \
  -d "payment_details[car_rental_data][0][pickup][address][line2]"="Apt 4B" \
  -d "payment_details[car_rental_data][0][pickup][time]"=1768500000 \
  -d "payment_details[car_rental_data][0][pickup][location_name]"="Downtown Garage" \
  -d "payment_details[car_rental_data][0][drop_off][address][line1]"="456 Elm St" \
  -d "payment_details[car_rental_data][0][drop_off][address][postal_code]"=02101 \
  -d "payment_details[car_rental_data][0][drop_off][address][city]"=Boston \
  -d "payment_details[car_rental_data][0][drop_off][address][country]"=US \
  -d "payment_details[car_rental_data][0][drop_off][address][state]"=MA \
  -d "payment_details[car_rental_data][0][drop_off][address][line2]"="Suite 101" \
  -d "payment_details[car_rental_data][0][drop_off][time]"=1768777200 \
  -d "payment_details[car_rental_data][0][drop_off][location_name]"="Airport Terminal" \
  -d "payment_details[car_rental_data][0][total][amount]"=30000 \
  -d "payment_details[car_rental_data][0][total][rate_per_unit]"=1500 \
  -d "payment_details[car_rental_data][0][total][rate_unit]"=days \
  -d "payment_details[car_rental_data][0][total][tax][tax_exempt_indicator]"=false \
  -d "payment_details[car_rental_data][0][total][tax][taxes][0][rate]"=10 \
  -d "payment_details[car_rental_data][0][total][tax][taxes][0][amount]"=3000 \
  -d "payment_details[car_rental_data][0][total][tax][taxes][0][type]"="Sales Tax" \
  -d "payment_details[car_rental_data][0][total][extra_charges][0][amount]"=2000 \
  -d "payment_details[car_rental_data][0][total][extra_charges][0][type]"=gps \
  -d "payment_details[car_rental_data][0][total][discounts][maximum_free_miles_or_kilometers]"=100 \
  -d "payment_details[car_rental_data][0][total][discounts][corporate_client_code]"=CORP123 \
  -d "payment_details[car_rental_data][0][total][discounts][coupon]"=SAVE20 \
  -d "payment_details[car_rental_data][0][insurances][0][insurance_type]"=liability_supplement \
  -d "payment_details[car_rental_data][0][insurances][0][amount]"=1500 \
  -d "payment_details[car_rental_data][0][vehicle][vehicle_class]"=premium_economy \
  -d "payment_details[car_rental_data][0][vehicle][type]"=compact \
  -d "payment_details[car_rental_data][0][vehicle][make]"=Toyota \
  -d "payment_details[car_rental_data][0][vehicle][model]"=Camry \
  -d "payment_details[car_rental_data][0][vehicle][vehicle_identification_number]"=1HGBH41JXMN109186 \
  -d "payment_details[car_rental_data][0][vehicle][odometer]"=25000 \
  -d "payment_details[car_rental_data][0][affiliate][name]"="Travel Partner" \
  -d "payment_details[car_rental_data][0][affiliate][code]"=TP001

Capturer un PaymentIntent

Vous pouvez inclure et mettre à jour les payment_details lors de la capture de la PaymentIntent. Assurez-vous que les données que vous fournissez sont complètes, car les payment_details ne peuvent pas être modifiés après la capture d’une PaymentIntent. Pour en savoir plus sur ce que représente chaque propriété, consultez la page envoi de données spécifiques au secteur.

Command Line
Sélectionner une languecURL
 No results
curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/capture \
  -u "sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "payment_details[car_rental_data][0][booking_number]"=BOOK123456 \
  -d "payment_details[car_rental_data][0][days_rented]"=3 \
  --data-urlencode "payment_details[car_rental_data][0][customer_service_phone_number]"="+18005551234" \
  -d "payment_details[car_rental_data][0][renter_name]"="John Doe" \
  -d "payment_details[car_rental_data][0][no_show_indicator]"=false \
  -d "payment_details[car_rental_data][0][distance][amount]"=150 \
  -d "payment_details[car_rental_data][0][distance][unit]"=miles \
  -d "payment_details[car_rental_data][0][drivers][0][name]"="Jane Driver" \
  -d "payment_details[car_rental_data][0][drivers][0][driver_identification_number]"=D12345678 \
  -d "payment_details[car_rental_data][0][drivers][0][driver_tax_number]"=TN123456789 \
  -d "payment_details[car_rental_data][0][pickup][address][line1]"="123 Main St" \
  -d "payment_details[car_rental_data][0][pickup][address][postal_code]"=10001 \
  -d "payment_details[car_rental_data][0][pickup][address][city]"="New York" \
  -d "payment_details[car_rental_data][0][pickup][address][country]"=US \
  -d "payment_details[car_rental_data][0][pickup][address][state]"=NY \
  -d "payment_details[car_rental_data][0][pickup][address][line2]"="Apt 4B" \
  -d "payment_details[car_rental_data][0][pickup][time]"=1768500000 \
  -d "payment_details[car_rental_data][0][pickup][location_name]"="Downtown Garage" \
  -d "payment_details[car_rental_data][0][drop_off][address][line1]"="456 Elm St" \
  -d "payment_details[car_rental_data][0][drop_off][address][postal_code]"=02101 \
  -d "payment_details[car_rental_data][0][drop_off][address][city]"=Boston \
  -d "payment_details[car_rental_data][0][drop_off][address][country]"=US \
  -d "payment_details[car_rental_data][0][drop_off][address][state]"=MA \
  -d "payment_details[car_rental_data][0][drop_off][address][line2]"="Suite 101" \
  -d "payment_details[car_rental_data][0][drop_off][time]"=1768777200 \
  -d "payment_details[car_rental_data][0][drop_off][location_name]"="Airport Terminal" \
  -d "payment_details[car_rental_data][0][total][amount]"=30000 \
  -d "payment_details[car_rental_data][0][total][rate_per_unit]"=1500 \
  -d "payment_details[car_rental_data][0][total][rate_unit]"=days \
  -d "payment_details[car_rental_data][0][total][tax][tax_exempt_indicator]"=false \
  -d "payment_details[car_rental_data][0][total][tax][taxes][0][rate]"=10 \
  -d "payment_details[car_rental_data][0][total][tax][taxes][0][amount]"=3000 \
  -d "payment_details[car_rental_data][0][total][tax][taxes][0][type]"="Sales Tax" \
  -d "payment_details[car_rental_data][0][total][extra_charges][0][amount]"=2000 \
  -d "payment_details[car_rental_data][0][total][extra_charges][0][type]"=gps \
  -d "payment_details[car_rental_data][0][total][discounts][maximum_free_miles_or_kilometers]"=100 \
  -d "payment_details[car_rental_data][0][total][discounts][corporate_client_code]"=CORP123 \
  -d "payment_details[car_rental_data][0][total][discounts][coupon]"=SAVE20 \
  -d "payment_details[car_rental_data][0][insurances][0][insurance_type]"=liability_supplement \
  -d "payment_details[car_rental_data][0][insurances][0][amount]"=1500 \
  -d "payment_details[car_rental_data][0][vehicle][vehicle_class]"=premium_economy \
  -d "payment_details[car_rental_data][0][vehicle][type]"=compact \
  -d "payment_details[car_rental_data][0][vehicle][make]"=Toyota \
  -d "payment_details[car_rental_data][0][vehicle][model]"=Camry \
  -d "payment_details[car_rental_data][0][vehicle][vehicle_identification_number]"=1HGBH41JXMN109186 \
  -d "payment_details[car_rental_data][0][vehicle][odometer]"=25000 \
  -d "payment_details[car_rental_data][0][affiliate][name]"="Travel Partner" \
  -d "payment_details[car_rental_data][0][affiliate][code]"=TP001

Moyens de transport multiples

Vous pouvez également ajouter plusieurs types de données sectorielles à un seul objet payment_details afin de fournir des informations sur les transactions impliquant plusieurs étapes de voyage. Pour en savoir plus sur ce que représente chaque propriété, consultez la page Envoi de données spécifiques au secteur.

Command Line
Sélectionner une languecURL
 No results
curl https://api.stripe.com/v1/payment_intents \
  -u "sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=200 \
  -d currency=usd \
  -d "payment_method_types[0]"=card \
  -d "payment_details[car_rental_data][0][booking_number]"=BOOK123456 \
  -d "payment_details[car_rental_data][0][days_rented]"=3 \
  --data-urlencode "payment_details[car_rental_data][0][customer_service_phone_number]"="+18005551234" \
  -d "payment_details[car_rental_data][0][renter_name]"="John Doe" \
  -d "payment_details[car_rental_data][0][no_show_indicator]"=false \
  -d "payment_details[car_rental_data][0][distance][amount]"=150 \
  -d "payment_details[car_rental_data][0][distance][unit]"=miles \
  -d "payment_details[car_rental_data][0][drivers][0][name]"="Jane Driver" \
  -d "payment_details[car_rental_data][0][drivers][0][driver_identification_number]"=D12345678 \
  -d "payment_details[car_rental_data][0][drivers][0][driver_tax_number]"=TN123456789 \
  -d "payment_details[car_rental_data][0][pickup][address][line1]"="123 Main St" \
  -d "payment_details[car_rental_data][0][pickup][address][postal_code]"=10001 \
  -d "payment_details[car_rental_data][0][pickup][address][city]"="New York" \
  -d "payment_details[car_rental_data][0][pickup][address][country]"=US \
  -d "payment_details[car_rental_data][0][pickup][address][state]"=NY \
  -d "payment_details[car_rental_data][0][pickup][address][line2]"="Apt 4B" \
  -d "payment_details[car_rental_data][0][pickup][time]"=1768500000 \
  -d "payment_details[car_rental_data][0][pickup][location_name]"="Downtown Garage" \
  -d "payment_details[car_rental_data][0][drop_off][address][line1]"="456 Elm St" \
  -d "payment_details[car_rental_data][0][drop_off][address][postal_code]"=02101 \
  -d "payment_details[car_rental_data][0][drop_off][address][city]"=Boston \
  -d "payment_details[car_rental_data][0][drop_off][address][country]"=US \
  -d "payment_details[car_rental_data][0][drop_off][address][state]"=MA \
  -d "payment_details[car_rental_data][0][drop_off][address][line2]"="Suite 101" \
  -d "payment_details[car_rental_data][0][drop_off][time]"=1768777200 \
  -d "payment_details[car_rental_data][0][drop_off][location_name]"="Airport Terminal" \
  -d "payment_details[car_rental_data][0][total][amount]"=30000 \
  -d "payment_details[car_rental_data][0][total][rate_per_unit]"=1500 \
  -d "payment_details[car_rental_data][0][total][rate_unit]"=days \
  -d "payment_details[car_rental_data][0][total][tax][tax_exempt_indicator]"=false \
  -d "payment_details[car_rental_data][0][total][tax][taxes][0][rate]"=10 \
  -d "payment_details[car_rental_data][0][total][tax][taxes][0][amount]"=3000 \
  -d "payment_details[car_rental_data][0][total][tax][taxes][0][type]"="Sales Tax" \
  -d "payment_details[car_rental_data][0][total][extra_charges][0][amount]"=2000 \
  -d "payment_details[car_rental_data][0][total][extra_charges][0][type]"=gps \
  -d "payment_details[car_rental_data][0][total][discounts][maximum_free_miles_or_kilometers]"=100 \
  -d "payment_details[car_rental_data][0][total][discounts][corporate_client_code]"=CORP123 \
  -d "payment_details[car_rental_data][0][total][discounts][coupon]"=SAVE20 \
  -d "payment_details[car_rental_data][0][insurances][0][insurance_type]"=liability_supplement \
  -d "payment_details[car_rental_data][0][insurances][0][amount]"=1500 \
  -d "payment_details[car_rental_data][0][vehicle][vehicle_class]"=premium_economy \
  -d "payment_details[car_rental_data][0][vehicle][type]"=compact \
  -d "payment_details[car_rental_data][0][vehicle][make]"=Toyota \
  -d "payment_details[car_rental_data][0][vehicle][model]"=Camry \
  -d "payment_details[car_rental_data][0][vehicle][vehicle_identification_number]"=1HGBH41JXMN109186 \
  -d "payment_details[car_rental_data][0][vehicle][odometer]"=25000 \
  -d "payment_details[car_rental_data][0][affiliate][name]"="Travel Partner" \
  -d "payment_details[car_rental_data][0][affiliate][code]"=TP001 \
  -d "payment_details[lodging_data][0][checkin_at]"=1771624800 \
  -d "payment_details[lodging_data][0][checkout_at]"=1771869600 \
  -d "payment_details[lodging_data][0][booking_number]"=HOTEL345678 \
  -d "payment_details[lodging_data][0][fire_safety_act_compliance_indicator]"=true \
  --data-urlencode "payment_details[lodging_data][0][customer_service_phone_number]"="+12025551234" \
  -d "payment_details[lodging_data][0][renter_name]"="Jane Smith" \
  -d "payment_details[lodging_data][0][renter_id_number]"=ID123456789 \
  -d "payment_details[lodging_data][0][no_show_indicator]"=false \
  --data-urlencode "payment_details[lodging_data][0][host][property_phone_number]"="+18005556789" \
  -d "payment_details[lodging_data][0][total][amount]"=50000 \
  -d "payment_details[lodging_data][0][total][prepaid_amount]"=25000 \
  -d "payment_details[lodging_data][0][total][cash_advances]"=10000 \
  -d "payment_details[lodging_data][0][total][tax][tax_exempt_indicator]"=false \
  -d "payment_details[lodging_data][0][total][tax][taxes][0][rate]"=10 \
  -d "payment_details[lodging_data][0][total][tax][taxes][0][amount]"=5000 \
  -d "payment_details[lodging_data][0][total][tax][taxes][0][type]"="City Tax" \
  -d "payment_details[lodging_data][0][total][extra_charges][0][amount]"=3000 \
  -d "payment_details[lodging_data][0][total][extra_charges][0][type]"=mini_bar \
  -d "payment_details[lodging_data][0][total][discounts][corporate_client_code]"=CORP456 \
  -d "payment_details[lodging_data][0][total][discounts][coupon]"=WINTER10 \
  -d "payment_details[lodging_data][0][accommodation][accommodation_type]"=suite \
  -d "payment_details[lodging_data][0][accommodation][nights]"=3 \
  -d "payment_details[lodging_data][0][accommodation][daily_rate_amount]"=15000 \
  -d "payment_details[lodging_data][0][accommodation][rate_type]"=Standard \
  -d "payment_details[lodging_data][0][accommodation][smoking_indicator]"=false \
  -d "payment_details[lodging_data][0][accommodation][bed_type]"=King \
  -d "payment_details[lodging_data][0][affiliate][name]"="Travel Network" \
  -d "payment_details[lodging_data][0][affiliate][code]"=TN987

Test

Vérifiez que votre intégration fonctionne correctement pour vos clients. Vous pouvez simuler des appels à l’API dans un environnement de test Stripe, à l’aide d’une clé d’environnement de test. Pour des informations supplémentaires, consultez la page test.

Lors des tests, vous pouvez vérifier les éléments suivants :

Les métadonnées de votre secteur sont correctement formatées et acceptées par l’API
Les champs obligatoires sont présents pour votre moyen de paiement (cartes ou Klarna)
La PaymentIntent traite vos métadonnées avec succès

Les tests effectués dans un environnement de test vérifient que votre intégration est techniquement correcte, mais ne simulent pas les décisions de qualification des réseaux de cartes ni les taux d’autorisation et les résultats de l’évaluation des risques de Klarna.