# Mirakl アプリを使用した決済と入金

Stripe Mirakl アプリを使って決済を受け付け、入金を行います。

[決済手段](https://docs.stripe.com/payments/payment-methods/overview.md)を 7 つのファミリーに分類しています。各ファミリーは同様の機能、単一の導入、共通の決済体験を備えています。[既存のアプリ](https://docs.stripe.com/use-stripe-apps.md)のいずれかを使用するか、[独自の導入](https://docs.stripe.com/payments.md)を構築して決済を受け付けることができます。

> 決済を実装する際、*連結する* (Connect is Stripe's solution for multi-party businesses, such as marketplace or software platforms, to route payments between sellers, customers, and other recipients)決済タイプを使用しないでください。プラグインは、Mirakl ベースの注文に基づいて[資金を分割](https://docs.stripe.com/use-stripe-apps/mirakl/payments.md#payment-split)します。

## 決済の作成

ユースケースや注文ワークフローに基づいて、支払い方法のカテゴリーを選択してください。

| ファミリー                                                                | 承認後に支払う  | 配送時に支払う  | 期日に支払う   |
| -------------------------------------------------------------------- | -------- | -------- | -------- |
| [カード](https://docs.stripe.com/payments/accept-a-payment.md)          | ✓ サポート対象 | ✓ サポート対象 | ✓ サポート対象 |
| [銀行口座引き落とし](https://docs.stripe.com/payments/bank-debits.md)         | ✓ サポート対象 | ✓ サポート対象 | ✓ サポート対象 |
| [銀行へのリダイレクト](https://docs.stripe.com/payments/bank-redirects.md)     | ✓ サポート対象 | 該当なし     | 該当なし     |
| [銀行振込](https://docs.stripe.com/payments/sources/credit-transfers.md) | ✓ サポート対象 | ✓ サポート対象 | ✓ サポート対象 |
| [後払い](https://docs.stripe.com/payments/buy-now-pay-later.md)         | ✓ サポート対象 | 該当なし     | 該当なし     |
| [店舗支払い](https://docs.stripe.com/payments/vouchers.md)                | ✓ サポート対象 | 該当なし     | 該当なし     |
| [ウォレット](https://docs.stripe.com/payments/wallets.md)                 | ✓ サポート対象 | 該当なし     | 該当なし     |

### 承認後に支払う

カードの場合、PaymentIntent をオーソリのみで完了するには、[capture_method](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-capture_method) オプションの値を `manual` に設定します。すべての売り手がそれぞれの注文を承認または拒否すると、コネクターがすぐに[売上を自動的にキャプチャー](https://docs.stripe.com/use-stripe-apps/mirakl/payments.md#payment-validation)します。注文は、オーソリの有効期間である 7 日以内に承認または拒否される必要があります。

銀行へのリダイレクト、ウォレット、後払いでは支払いの確認がすぐに行われるため、注文を自動的に受け付けるよう設定し、売り手が注文のフルフィルメントを実行できない場合は返金を使用することをお勧めします。

### 配送時に支払う

クレジットカードの場合、7 日以内に決済をキャプチャーするビジネスルールがある場合は、決済時にのみオーソリが可能です。そうでない場合は、[決済時にクレジットカード](https://docs.stripe.com/payments/save-and-reuse.md)を保存し、後でオーソリします。口座振替の場合、決済時に銀行口座を保存し、売り手が注文を受け付けた後に決済を開始することができます。

### 期日に支払う

Stripe Billing を使用して顧客に[請求書を送信](https://docs.stripe.com/invoicing/dashboard.md)すると、顧客は Stripe の[オンライン請求書ページ](https://docs.stripe.com/invoicing/hosted-invoice-page.md)で支払うことができます。

## 決済の確認

Mirakl の注文の支払いの検証を処理するには、埋め込みジョブを使用するか、クーポン提供などの特定のニーズがある場合はご自身で [PA01](https://help.mirakl.net/help/api-doc/operator/mmp.html#PA01) API を呼び出すことができます。

埋め込みジョブを有効にするには、まずメタデータを更新して、Mirakl の注文を成功した支払いにマッピングする必要があります。

```bash
curl https://api.stripe.com/v1/charges/ch_1Hmloy2eZvKYlo2C2Tx3W00V \
  -u <<YOUR_SECRET_KEY>>: \
  -d "metadata[mirakl_commercial_order_id]"=123
```

売り手がロジスティック注文を受けると、ワークフローが開始されます。

1. [決済の検証ジョブ](https://docs.stripe.com/use-stripe-apps/mirakl/reference.md#payment-validation)は、新しく受けた Mirakl の注文を取得します。
1. プラグインは Mirakl による支払いを検証します。
1. カードの場合、すべてのロジスティック注文が承認または拒否されると、支払いがキャプチャされます。
![](https://b.stripecdn.com/docs-statics-srv/assets/payment-validation.b4e38338cc8ca2b4b9a6b54381e11fb8.svg)

## 支払いの分割

支払いが Mirakl で検証され、Stripe でキャプチャされたときにワークフローは開始されます。

1. [支払いの分割ジョブ](https://docs.stripe.com/use-stripe-apps/mirakl/reference.md#payment-split)は、新しく検証された Mirakl の注文を取得します。
1. プラグインは、手数料を差し引いた後、注文金額を売り手に送金します。
![](https://b.stripecdn.com/docs-statics-srv/assets/payment-split.854d23364864078f73b0f85509048073.svg)

## 決済を返金する

Mirakl による注文の返金をリクエストすると、ワークフローが開始されます。

1. [支払いを返金するジョブ](https://docs.stripe.com/use-stripe-apps/mirakl/reference.md#payment-refund)は、新しく返金された Mirakl の注文を取得します。
1. プラグインは Stripe で返金を作成し、Mirakl で返金を検証してから、支払いの分割に使用された送金を差戻します。
![](https://b.stripecdn.com/docs-statics-srv/assets/payment-refund.542699f87703a1899287530589e40614.svg)

## 売り手への入金

売り手への各*入金* (A payout is the transfer of funds to an external account, usually a bank account, in the form of a deposit)の金額と頻度は、設定に基づいて Mirakl が制御します。**設定** > **ショップ** > **請求サイクル** で請求サイクルをカスタマイズできます。デフォルトでは、売り手は毎月 1 日、11 日、21 日に入金を受け取ります。

### 売り手の売上処理

Mirakl が新しい*請求書* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice)を生成すると、ワークフローが開始されます。

1. [入金ジョブ](https://docs.stripe.com/use-stripe-apps/mirakl/reference.md#payout)は新しく作成された Mirakl 請求書を取得します。
1. プラグインは、請求書の属性に基づいて次のアクションを実行します。

| 請求書の属性                          | 実行されたアクション         |
| ------------------------------- | ------------------ |
| `total_other_credits_incl_tax`  | オペレーターから売り手に送金します。 |
| `total_other_invoices_incl_tax` | 売り手からオペレーターへ送金します。 |
| `total_subscription_incl_tax`   | 売り手からオペレーターへ送金します。 |
| `amount_transferred`            | 売り手に入金。            |

手数料は [決済分割ワークフロー](https://docs.stripe.com/use-stripe-apps/mirakl/payments.md#payment-split)で既に処理されています。
![](https://b.stripecdn.com/docs-statics-srv/assets/payout.514743e5e90d9862245e84cc1c9d3ea2.svg)