Mirakl リファレンス

Mirakl コネクターイベントのデフォルト設定。

定期実行ジョブ

ユーザ登録

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

デフォルト設定: 毎分
推奨設定: できるだけ頻繁
説明: 新しく作成された Mirakl ショップを取得し、ユーザ登録リンクを Mirakl バックオフィスに追加します。
Documentation: Onboarding workflow.

支払いの検証

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

デフォルト設定: 5 分ごと
推奨設定: 1 時間未満
説明: 新しく受け付けられた Mirakl の注文を取り出し、Mirakl で支払いを検証し、Stripe でキャプチャします。
Documentation: Payment validation workflow.

支払いの分割

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

デフォルト設定: 5 分ごと
推奨設定: 1 時間未満
説明: 新しく引き落とされた Mirakl の注文を取り出し、オペレータから売り手への Stripe の送金を作成します。
Documentation: Payment split workflow.

支払いの返金

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

デフォルト設定: 5 分ごと
推奨設定: 1 時間未満
説明: 保留中の Mirakl の返金を取り込み、Stripe で返金を作成し、Mirakl で検証して、最初の送金を差戻します。
Documentation: Payment refund workflow.

入金

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

デフォルト設定: 毎日午前 1 時
推奨設定: Mirakel の請求サイクルと同期させる
説明: 新しく作成された Mirakl の請求書を取り出し、Stripe の送金および入金を作成します。
Documentation: Payouts workflow.

アラート

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

デフォルト設定: 毎日午前 8 時
推奨設定: お客様の選択に応じて
Description: if enabled, send an email with all the failed transfers, refunds, and payouts.

通知

If enabled, the connector sends server to server notifications in the following events.

注

エンドポイントに到達できない場合、またはエラーが返された場合は、TECHNICAL_ALERT_EMAIL にメールが送信されます。

アカウントが更新されました

Stripe の連結アカウントが、売り手または Stripe によって更新されました。

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

送金に失敗しました

支払い分割ジョブまたは入金ジョブ中に送金が失敗しました。

{
  "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"
  }
}

返金に失敗しました

支払いの返金ジョブ中に返金が失敗しました。

{
  "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"
  }
}

入金に失敗しました

入金ジョブ中に入金が失敗しました。

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