Accéder directement au contenu
Créez un compte
ou
connectez-vous
Le logo de la documentation Stripe
/
Demander à l’IA
Créer un compte
Connectez-vous
Commencer
Paiements
Revenus
Plateformes et places de marché
Gestion des fonds
Ressources pour les développeurs
Aperçu
Contrôle de version
Journal des modifications
Mettre à niveau votre version de l'API
Mettre à niveau votre version de la trousse SDK
Outils
Trousses SDK
API
Test
Workbench
Destinations des événements
Processus
Interface de ligne de commande Stripe
Shell Stripe
Dashboard des développeurs
Boîte à outils des agents
Développer avec des GMLStripe pour Visual Studio CodeAlertes sur la santé de StripeTéléversements de fichier
Sécurité et confidentialité
Sécurité
Confidentialité
Étendez Stripe
Stripe Apps
Connecteurs Stripe
    Aperçu
    Intégrer un connecteur
    Commercetools
    Adobe Commerce
    Mirakl
      Installation
      Configuration
      Inscription des marchands
      Paiements
      Virements
      Référence
    NetSuite
    Oracle Opera
    Cegid
    PrestaShop
    Salesforce
    SAP
    Shopware 6
    Stripe Tax for WooCommerce
    Stripe Tax pour BigCommerce
    Connecteurs de partenaires
    Créer votre propre connecteur
Partenaires
Partner ecosystem
Certification des partenaires
AccueilRessources pour les développeursStripe ConnectorsMirakl

Configuration du connecteur Mirakl

Définissez vos variables d’intégration.

Avant d’installer le connecteur, préparez un fichier contenant les variables ci-dessous.

Notre référentiel contient un exemple de fichier de configuration que vous pouvez copier et renommer .env.

Paramètres généraux

ParamètreDescription
APP_SECRETÀ générer. Sert généralement à ajouter une plus grande entropie aux opérations liées à la sécurité. Pour en savoir plus, consultez la documentation sur Symfony.
OPERATOR_PASSWORDÀ générer. Sert à confirmer les requêtes vers l’API exposée par le connecteur. Attribuez cette valeur à l’en-tête X-AUTH-TOKEN lorsque vous appelez l’API.
DATABASE_URLL’URL de connexion à votre base de données. Pour en savoir plus, consultez la documentation sur Doctrine. Par exemple pgsql://symfony:symfony@db:5432/symfony?charset=UTF-8.
MESSENGER_TRANSPORT_DSNLe moyen d’acheminement utilisé pour le système de mise en file d’attente. Consultez la documentation de Symfony Messenger pour connaître les moyens d’acheminement pris en charge. Par exemple, amqp://guest:guest@localhost:5672/%2f/messages. Sa valeur par défaut est doctrine://default.
STRIPE_CLIENT_SECRETVotre clé secrète API Stripe est disponible dans vos paramètres des clés API. Nous vous recommandons de créer une clé API réservée au connecteur. Les clés à usage limité ne sont pas prises en charge.
MIRAKL_HOST_NAMENom d’hôte de votre instance Mirakl. Par exemple, https://mymarketplace.mirakl.net.
MIRAKL_API_KEYLa clé d’opérateur Mirakl, qui peut être générée en tant qu’opérateur Mirakl dans vos paramètres d’API. Nous vous recommandons de créer un opérateur réservé au connecteur.

Inscription des utilisateurs

ParamètreDescription
REDIRECT_ONBOARDINGLe connecteur redirige le vendeur vers cette URL une fois son compte créé dans Stripe. La valeur par défaut est $MIRAKL_HOST_NAME/mmp/shop/account/shop.
BASE_HOSTLe domaine du serveur qui héberge votre connecteur. Par exemple : stripe-mirakl.example.com.
SCHEMELe schéma utilisé par votre hôte de base. Sa valeur par défaut est https.
STRIPE_SELLERS_WEBHOOK_SECRETVotre clé secrète de webhook Stripe est disponible dans vos paramètres de webhook Connect lorsque vous ajoutez le point de terminaison. Voir ci-dessous.
MIRAKL_CUSTOM_FIELD_CODECode du champ personnalisé que vous devez ajouter; voir ci-dessous. Sa valeur par défaut est stripe-url.

Ajouter un point de terminaison de webhook Stripe pour les comptes connectés

  1. Rendez-vous dans vos paramètres des webhooks.
  2. Ajoutez un point de terminaison de webhook.
  3. Définissez l’URL sur <BASE_HOST>/api/public/webhook/sellers.
  4. Sélectionnez Écouter des événements sur des comptes connectés.
  5. Ajoutez account.updated aux Événements à envoyer :
  6. Cliquez sur Ajouter un point de terminaison.
  7. Utilisez la clé secrète de webhook pour la variable d’environnement STRIPE_SELLERS_WEBHOOK_SECRET.

Ajouter un champ personnalisé à vos boutiques Mirakl

  1. Connectez-vous à votre application administrative Mirakl en tant qu’opérateur.
  2. Accédez à Paramètres > Paramètres avancés > Boutiques.
  3. Rendez-vous dans l’onglet Champs personnalisés.
  4. Créez un nouveau champ à l’aide des valeurs suivantes :
ParamètreDescription
CodeUtilisez stripe-url, sauf si vous choisissez une clé différente dans votre fichier d’environnement.
TypeLink
Autorisations des boutiquesLecture seule
Champ obligatoireNo

Paiements

ParamètreDescription
PAYMENT_METADATA_COMMERCIAL_ORDER_IDClé de métadonnées utilisée dans Charges pour transférer l’identifiant de commande commerciale Mirakl, et dont la valeur par défaut est mirakl_commercial_order_id.
ENABLE_PRODUCT_PAYMENT_SPLITActivez le flux de fractionnement des paiements pour les commandes de produits. Sa valeur par défaut est false.
ENABLE_SERVICE_PAYMENT_SPLITActivez le flux de fractionnement des paiements pour les commandes de services. Sa valeur par défaut est false.
ENABLE_PRODUCT_PAYMENT_REFUNDActivez le flux de remboursement des paiements pour les commandes de produits. Sa valeur par défaut est false.
ENABLE_SERVICE_PAYMENT_REFUNDActivez le flux de remboursement des paiements pour les commandes de services. Sa valeur par défaut est false.
STRIPE_OPERATOR_WEBHOOK_SECRETVotre clé secrète de webhook Stripe est disponible dans vos paramètres de webhook de compte lorsque vous ajoutez le point de terminaison; voir ci-dessous.

Ajouter un point de terminaison de webhook Stripe pour votre compte

  1. Rendez-vous dans vos paramètres des webhooks.
  2. Ajoutez un point de terminaison de webhook pour votre compte.
  3. Définissez l’URL sur <BASE_HOST>/api/public/webhook/operator.
  4. Ajoutez ce qui suit aux événements à envoyer: charge.succeeded, charge.updated.
  5. Cliquez sur Ajouter un point de terminaison.
  6. Utilisez la clé secrète de webhook pour la variable d’environnement STRIPE_OPERATOR_WEBHOOK_SECRET.

Notifications et alertes

ParamètreDescription
MAILER_DSNL’ensemble de la configuration de Symfony Mailer qui utilise un format d’URL de type DSN. Pour en savoir plus, consultez la documentation de Symfony. Par exemple smtp://user:pass@host:port. Sa valeur par défaut est smtp://null (expéditeur désactivé)
TECHNICAL_ALERT_EMAILLe destinataire des alertes techniques. Par exemple, myemail@example.com. Sa valeur par défaut est nulle. Obligatoire si l’expéditeur est activé par MAILER_DSN.
TECHNICAL_ALERT_EMAIL_FROML’expéditeur de tous les courriels techniques. Sa valeur par défaut est nulle. Obligatoire si l’expéditeur est configuré. Par exemple : noreply@example.com.
OPERATOR_NOTIFICATION_URLLe point de terminaison de votre serveur qui est configuré pour recevoir des notifications du connecteur. Sa valeur par défaut est nulle (notifications désactivées).
MAIL_ON_NOTIFICATION_ENDPOINT_DOWNActivez les alertes par courriel si une URL est fournie dans OPERATOR_NOTIFICATION_URL et que cette URL n’est pas disponible ou renvoie une erreur. La valeur par défaut est définie à true.
MAIL_ON_NOTIFICATION_ENDPOINT_DOWN_COOLDOWNIntervalle entre chaque alerte par courriel. Utilisez 0 pour désactiver la limitation. La valeur maximale dépend de la durée de vie maximale du traitement des notifications, à savoir 3600par défaut. La valeur par défaut est définie à 10.

Voir aussi

  • Étapes d’intégration.
Cette page vous a-t-elle été utile?
OuiNon
Besoin d'aide? Contactez le service d'assistance.
Rejoignez notre programme d'accès anticipé.
Consultez notre journal des modifications.
Des questions? Contactez l'équipe commerciale.
GML? Lire llms.txt.
Optimisé par Markdoc