Guide d'intégration pour parc automobile
Développez une intégration de services financiers pour parc automobile avec Issuing.
Créez une offre pour parc automobile à l’aide de Stripe Issuing pour créer des cartes et traiter les transactions de vos clients professionnels.
À la fin de ce guide, vous saurez comment :
- Créer des comptes connectés vérifiés représentant vos entreprises clientes.
- Créer des cartes pour vos clients et les utiliser pour dépenser des fonds.
- Appréhender les champs supplémentaires spécifiques aux parcs automobiles recueillis à la pompe ou au point de vente.
Avant de commencer
- Créez un Compte Stripe.
- Activer Issuing dans un environnement de test du Dashboard.
- Configurez les paramètres de marque de la plateforme Connect de votre entreprise et ajoutez une icône.
Présentation
Stripe Issuing permet aux plateformes de gestion de parc automobile et aux opérateurs de créer et de gérer des programmes personnalisés pour parcs automobiles, avec des cartes de paiement physiques ou virtuelles. Issuing permet aux utilisateurs de contrôler, gérer et réconcilier efficacement les dépenses liées aux parcs de véhicules électriques ou thermiques de leurs clients.
La plateforme Stripe offre des fonctionnalités avancées, avec des cartes en boucle ouverte acceptées dans toutes les enseignes, des contrôles de dépenses en temps réel au point de vente, une protection avancée contre la fraude grâce aux outils de lutte contre la fraude et aux signaux d’autorisation de Stripe, et la possibilité de définir des avantages de carte propres à votre programme, par exemple 1 % de cashback sur les achats de carburant. Les fournisseurs de parc automobile peuvent également émettre des cartes liées à des véhicules ou des groupes de véhicules spécifiques pour permettre un suivi précis des dépenses (notamment les relevés kilométriques) et limiter les achats à certains conducteurs, certains marchands ou certaines catégories de dépenses.
La plateforme Stripe donne accès à des informations utiles sur les schémas de dépenses, le kilométrage, l’entretien des véhicules ou les détails des transactions, ce qui permet aux entreprises de personnaliser leur programme de parc automobile. Cette approche offre une plus grande efficacité opérationnelle. Elle permet également de réaliser des économies et de suivre les dépenses de carburant, de maintenance, de nourriture, d’hébergement, etc.
Créer des comptes connectés
Créer un compte connecté
Créez un compte connecté pour représenter une entreprise cliente de votre plateforme. Pour votre plateforme, chaque opérateur de parc automobile est représenté par un compte connecté.
Types de comptes Connect
Issuing prend uniquement en charge les comptes connectés qui n’utilisent pas de Dashboard hébergé par Stripe, et dont votre plateforme est responsable de la collecte des exigences et des pertes, c’est-à-dire les comptes connectés Custom. Découvrez comment créer des comptes connectés qui fonctionnent avec Issuing. Si vos comptes existants ne correspondent pas à cette configuration, vous devez les recréer.
La requête suivante crée un compte connecté établi aux États-Unis avec la bonne configuration et demande les fonctionnalités requises :
Les informations du compte de l’utilisateur apparaissent dans la réponse :
{ ... "id": "{{CONNECTED_ACCOUNT_ID}}", "controller": { "stripe_dashboard": { "type": "none" }, "fees": { "payer": "application" }, "losses": { "payments": "application" }, "is_controller": true, "type": "application", "requirement_collection": "application" }, ... }
Notez l’id du compte connecté. Vous le transmettrez dans les requêtes de l’en-tête Stripe-Account pour vous authentifier sous ce compte.
Si un compte connecté existe déjà, vous pouvez ajouter les fonctionnalités requises en spécifiant son id dans la requête :
Vérifier le compte connecté
Choisissez l’une des options d’inscription des utilisateurs suivantes :
À ce stade, Stripe a créé et vérifié le compte connecté, qui est doté des fonctionnalités active pertinentes pour l’utilisation de Issuing et Treasury.
Pour en savoir plus, consultez les pages suivantes :
Utiliser la carte
Lorsqu’une carte bancaire est utilisée pour effectuer un achat, une demande d’autorisation est générée, qui pourra être approuvée ou refusée en temps réel.
Lorsque vous aurez configuré un programme de cartes pour parc automobile, vous pourrez accéder à des champs supplémentaires réservés à ce type de cartes, qui seront recueillis à la pompe ou au point de vente (relevé de compteur kilométrique, identification du conducteur, type de carburant, litres de carburant, et informations détaillées sur différents produits autres que le carburant), grâce à une puce dédiée sur la carte. Ces données sont disponibles au point de vente lors de l’autorisation, puis lors du traitement de la transaction. Certains distributeurs de carburant permettent une autorisation partielle.
Créer une autorisation
Pour observer l’impact des activités de carte sur le solde associé, générez une autorisation de test.
En tant qu’utilisateur d’un programme de cartes pour parc automobile d’entreprise, vous recevez des données spécifiques relatives aux parcs automobiles dans l’objet Authorization.
Vous pouvez créer une autorisation de test sur la page Issuing du Dashboard pour le compte connecté ou avec l’appel suivant à l’API Authorizations :
Après approbation, Stripe crée une Authorization à l’état pending en attendant la capture.
Le montant (amount) autorisé est le montant retenu par défaut pour une transaction à un distributeur de carburant, sauf si vous avez fourni un montant d’autorisation partielle différent dans votre réponse au webhook issuing_.
Notez l’id d’autorisation que vous utiliserez pour capturer les fonds :
{ "id": "iauth_1NvPyY2SSJdH5vn2xZQE8C7k", "object": "issuing.authorization", "amount": 10000, ... "fleet": { "cardholder_prompt_data": { "odometer": 42424, }, "purchase_type": "fuel_purchase", "service_type": "self_service", }, "status": "pending", "transactions": [], }
Simuler l’achèvement d’une transaction à un distributeur de carburant
Dans les environnements de test, vous pouvez simuler la fin de la distribution de carburant à l’aide du code suivant :
L’objet Authorization reste à l’état pending jusqu’à sa capture. La quantité est mise à jour pour refléter la quantité totale de carburant distribuée, et des champs supplémentaires spécifiques aux parcs automobiles sont désormais disponibles :
{ "id": "iauth_1NvPyY2SSJdH5vn2xZQE8C7k", "object": "issuing.authorization", "amount": 1000, ... "fleet": { "cardholder_prompt_data": { "odometer": 42424, }, "purchase_type": "fuel_purchase", "reported_breakdown": { "fuel": { "gross_amount_decimal": "10.0", }, "non_fuel": { "gross_amount_decimal": "0" }, "tax": { "local_amount_decimal": "0.03", "national_amount_decimal": null } }, "service_type": "self_service", }, "fuel": { "industry_product_code": "001", "quantity_decimal": "5.0", "type": "unleaded_regular", "unit": "us_gallon", "unit_cost_decimal": "200", }, "status": "pending", "transactions": [], }
Capturer les fonds
Dans les environnements de test, vous pouvez capturer les fonds à l’aide du code suivant :
Une fois l’autorisation capturée, Stripe crée une transaction Issuing et l’attribut status de l’autorisation est défini sur closed.
En tant qu’utilisateur d’un programme de cartes pour parc automobile d’entreprise, vous recevez des données spécifiques à ce type de carte lors de la transaction (par exemple, pour rapprocher les achats).
{ "id": "ipi_1MykXhFtDWhhyHE1UjsZZ3xQ", "object": "issuing.transaction", "amount": 1000, ... "purchase_details": { "fleet": { "cardholder_prompt_data": { "odometer": 42424, }, "purchase_type": "fuel_purchase", "reported_breakdown": { "fuel": { "gross_amount_decimal": "10.0", }, "non_fuel": { "gross_amount_decimal": "0" }, "tax": { "local_amount_decimal": "0.03", "national_amount_decimal": null } }, "service_type": "self_service", }, "fuel": { "industry_product_code": "001", "quantity_decimal": "5.0", "type": "unleaded_regular", "unit": "us_gallon", "unit_cost_decimal": "200", }, } }