Paiements à l'aide du connecteur Mirakl

Nous classons les moyens de paiement en sept familles. Chaque famille dispose de caractéristiques analogues, d’une intégration unique et d’expériences de règlement communes.

Vous pouvez utiliser l’un de nos connecteurs existants ou créer votre propre intégration d’acceptation des paiements.

Création du paiement

Choisissez les types de moyens de paiement selon le flux de commande le plus adapté à votre cas d’usage.

Voici quelques règles supplémentaires pour adapter votre intégration des paiements à vos flux.

Payer lors de l’acceptation

En ce qui concerne les cartes, définissez la valeur de l’option capture_method sur manual lorsque vous exécutez le PaymentIntent uniquement à des fins d’autorisation. Le connecteur capturera les fonds automatiquement dès que tous les marchands auront accepté ou refusé leurs commandes respectives. Les commandes doivent être acceptées ou refusées sous 7 jours, soit la durée de validité d’une autorisation.

La confirmation de paiement étant immédiate pour les virements avec redirection bancaire, les paiements différés et les portefeuilles électroniques, nous vous recommandons de configurer vos commandes pour qu’elles soient acceptées automatiquement et d’effectuer des remboursements lorsque les marchands ne sont pas en mesure d’honorer leurs commandes.

Payer à la livraison

Pour les cartes, vous pouvez autoriser uniquement lors du règlement si vous avez mis en place des règles permettant de capturer le paiement sous 7 jours. Dans le cas contraire, enregistrez la carte lors du règlement et autorisez plus tard.

Pour les débits bancaires, vous pouvez enregistrer le compte bancaire lors du règlement et effectuer le paiement après que le marchand a accepté la commande.

Payer à la date d’échéance

Vous pouvez utiliser Stripe Billing pour envoyer une facture à vos clients, lesquels pourront ensuite la payer via notre page de facture hébergée.

Validation des paiements

Pour traiter la validation de paiement de vos commandes Mirakl, vous pouvez recourir à la tâche intégrée ou appeler l’API PA01 vous-même si vous avez des besoins spécifiques, comme l’offre de bons de réduction.

Pour activer la tâche intégrée, vous devez d’abord mapper la commande Mirakl au paiement réussi en mettant à jour les métadonnées :

curl https://api.stripe.com/v1/charges/ch_1Hmloy2eZvKYlo2C2Tx3W00V \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "metadata[mirakl_commercial_order_id]"=123

Le flux commence lorsque le marchand accepte sa commande logistique.

1. La tâche de validation des paiements récupère les dernières commandes Mirakl acceptées.
2. Le connecteur valide le paiement dans Mirakl.
3. Pour les cartes, le paiement est capturé dès lors que l’ensemble des commandes logistiques ont été acceptées ou refusées.

Fractionnement des paiements

Le flux commence lorsque le paiement est validé dans Mirakl et capturé dans Stripe.

1. La tâche de fractionnement des paiements récupère les dernières commandes Mirakl validées.
2. Le connecteur transfère le montant de la commande au marchand après déduction de votre commission.

Remboursement de paiement

Le flux commence lorsque vous demandez le remboursement d’une commande Mirakl.

1. La tâche de remboursement des paiements récupère les dernières commandes Mirakl remboursées.
2. Le connecteur crée un remboursement dans Stripe, valide le remboursement dans Mirakl puis annule le transfert utilisé pour fractionner le paiement.