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 back-office Mirakl.
Documentation : flux 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 fonction est activée, envoyez un e-mail listant l’ensemble des transferts, remboursements et virements en échec.

Notification

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

Note

Si votre endpoint est inaccessible ou renvoie une erreur, un e-mail 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",
  }
}