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.
With a configured fleet card program, you’ll access additional fleet-specific fields gathered at the pump or point of sale. This includes odometer reading, driver identification, fuel type, gallons pumped, and itemized non-fuel product details, enabled by a fleet-specific chip configuration on the card. This data becomes available at the point of purchase during authorization, and later when the transaction is processed. Some fuel dispensers allow partial authorization.
Créer une autorisation
To observe the impact of card activity on the associated balance, generate a test authorization.
As a user with a Commercial Fleet card program, you receive specific fleet-related data on the Authorization object.
You can create a test authorization on the Issuing page of the Dashboard for the connected account, or with the following call to the Authorizations API:
After approval, Stripe creates an Authorization in a pending state while it waits for capture.
The authorized amount is the default amount held for a fuel dispenser transaction unless you’ve provided a different partial authorization amount in your response to the issuing_ webhook.
Make note of the authorization id that you’ll use to capture the funds:
{ "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": [], }
Simulate fuel dispenser completion
In testing environments, you can simulate the completion of fuel being dispensed using the following code:
The Authorization remains in a pending state until it’s captured. The amount is updated to reflect the total amount of fuel dispensed, and additional fleet-specific fields are now available:
{ "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
In testing environments, you can capture the funds using the following code:
After the authorization is captured, Stripe creates an Issuing Transaction, the status of the authorization is set to closed.
As a user with a Commercial Fleet card program, you receive specific fleet-related data on the Transaction, (for example, to reconcile purchases).
{ "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", }, } }