Référence Mirakl

Paramètres par défaut pour les événements du connecteur Mirakl.

Tâches planifiées

Inscription des utilisateurs

Command Line
php bin/console connector:sync:onboarding -q 2>&1

Paramètre par défaut : toutes les minutes.
Paramètre recommandé : aussi souvent que possible.
Description : récupère les dernières boutiques Mirakl créées et ajoute le lien d’inscription des utilisateurs à leur application administrative Mirakl.
Documentation : processus d’inscription des utilisateurs.

Validation des paiements

Command Line
php bin/console connector:validate:pending-debit -q 2>&1

Paramètre par défaut : toutes les 5 minutes.
Paramètre recommandé : < 1 heure.
Description : récupère les dernières commandes Mirakl acceptées, valide le paiement sur Mirakl et le capture sur Stripe.
Documentation : flux de validation des paiements.

Fractionnement des paiements

Command Line
php bin/console connector:dispatch:process-transfer -q 2>&1

Paramètre par défaut : toutes les 5 minutes.
Paramètre recommandé : < 1 heure.
Description : récupère les dernières commandes Mirakl débitées et crée des transferts Stripe de l’opérateur vers le marchand.
Documentation : flux de fractionnement des paiements.

Remboursement des paiements

Command Line
php bin/console connector:dispatch:process-refund -q 2>&1

Paramètre par défaut : toutes les 5 minutes.
Paramètre recommandé : < 1 heure.
Description : récupère les remboursements Mirakl en attente, crée le remboursement sur Stripe, le valide sur Mirakl et annule le transfert initial.
Documentation : flux de remboursement des paiements.

Virement

Command Line
php bin/console connector:dispatch:process-payout -q 2>&1

Paramètre par défaut : tous les jours à 01 h 00.
Paramètre recommandé : synchronisé avec vos cycles de facturation Mirakl.
Description : récupère les dernières factures Mirakl créées et crée des transferts et des virements Stripe.
Documentation : flux de virement.

Alertes

Command Line
php bin/console connector:notify:failed-operation -q 2>&1

Paramètre par défaut : tous les jours à 08 h 00.
Paramètre recommandé : selon vos préférences.
Description : si cette option est activée, un courriel indiquant l’ensemble des transferts, remboursements et virements ayant échoué doit être envoyé.

Notification

Si cette option est activée, le connecteur enverra des notifications de serveur à serveur pour les événements suivants.

Remarques

Si votre point de terminaison est inaccessible ou renvoie une erreur, un courriel est envoyé à votre TECHNICAL_ALERT_EMAIL.

Compte mis à jour

Un compte connecté Stripe a été mis à jour par le marchand ou Stripe.

{
  "type": "account.updated",
  "payload": {
    "miraklShopId": 2000,
    "stripeUserId": "acct_1032D82eZvKYlo2C"
  }
}

Échec du transfert

Un transfert a échoué lors de la tâche de fractionnement du paiement ou de la tâche de virement.

{
  "type": "transfer.failed",
  "payload": {
    "internalId": 5,
    "miraklId": 123,
    "type": "TRANSFER_ORDER",
    "stripeAccountId": "acct_1032D82eZvKYlo2C",
    "miraklShopId": 2003,
    "transferId": null,
    "transactionId": null,
    "amount": 3400,
    "status": "TRANSFER_FAILED",
    "failedReason": "Reason message",
    "currency": "EUR"
  }
}

Échec du remboursement

Un remboursement a échoué lors de la tâche de remboursement d’un paiement.

{
  "type": "refund.failed",
  "payload": {
    "internalId": 5,
    "miraklOrderId": "order_refunded_5",
    "miraklRefundId": "1100",
    "stripeRefundId": null,
    "stripeReversalId": "trr_10",
    "amount": 3400,
    "status": "REFUND_FAILED",
    "failedReason": "Reason message",
    "currency": "EUR"
  }
}

Échec du virement

Un virement a échoué lors de la tâche de virement.

{
  "type": "payout.failed",
  "payload": {
    "internalId": 12,
    "amount": 2300,
    "currency": "EUR",
    "miraklInvoiceId": 2000,
    "stripePayoutId": null,
    "status": "PAYOUT_FAILED",
    "failedReason": "Reason message",
  }
}