プラットフォーム向けで決済を処理するには、プラットフォーム事業者が決済処理事業者である「販売者決済処理モデル」を採用する必要があります。

決済を作成する

(1) 決済資金フローのロジック

加盟店は、プラットフォーム事業者から請求する取引あたりのプラットフォーム手数料の金額を指定できます。
処理業者であるプラットフォーム事業者が、KOMOJU に決済手数料を支払います。

(2) API 経由で決済を作成する

PCI-DSS に準拠している場合は、Payment API 経由で決済を作成することで、カードの詳細を貴社のサーバーに送信し、顧客の決済情報を直接 KOMOJU に送信できます。

Payment: Create API をリクエストする必要があります。こちらのガイドで、Payment API 経由で支払いを作成する方法を説明しています。

決済リクエストを行う際には、1) どのプラットフォーム事業者が決済を処理するのかを processing_merchant_id で指定し、2) プラットフォーム事業者に請求するプラットフォーム手数料を submerchant_id と platform_fee で指定する必要があります。

 "platform_details": { 
    "processing_merchant_id": "submerchant_one",
    "submerchants": [
      {
        "submerchant_id": "submerchant_one",
        "platform_fee": "100",
        "amount": "700"
      }
    ]

リクエスト属性	型	説明
processing_merchant_id	string	決済を処理するプラットフォーム事業者の ID を指定する必要があります。
submerchant_id	string	プラットフォーム事業者の `ID`。
platform_fee	integer	プラットフォーム事業者に請求するプラットフォーム手数料の金額。
amount	integer	プラットフォーム事業者に入金される金額。

上記の例では、processing_merchant は submerchant_one です。

submerchant の認証情報が決算リクエストの処理に使用される
submerchant の残高に決済の amount が入金される
platform_fee が submerchant の残高から加盟店の残高に移行される
submerchant が KOMOJU 手数料を支払う

📘
取引の入金時の決済分割ロジックを指定する必要があります
取引の入金の際は、platform_details 配列内に金額とプラットフォーム手数料を指定する必要があります。これは、システムがそれに基づいて決済を分割するためです。

Payment: Create のリクエスト時に capture を true と指定した場合、platform_details 配列で決済分割 (プラットフォーム事業者への金額とプラットフォーム手数料の金額) を指定する必要があります。

それに対して、Payment: Create のリクエストの際に capture を false と指定した場合は、決済の分割に関する情報は後で Payment: Capture をリクエストする際に提供できます。

(3) ホストページ経由で決済を作成する

KOMOJU ホストページは、デフォルトで PCI 準拠と 3D セキュアに対応しています。そのため、貴社が PCI-DSS 準拠に対応していない場合は、このソリューションが推奨されます。チェックアウト中に、顧客は決済を完了するために KOMOJU のホストページにリダイレクトされます。こちらのガイドでは、KOMOJU ホストページのセッションを作成する方法を説明しています。

まず Session: Create API をリクエストして、1) どのプラットフォーム事業者が決済を処理するのかを processing_merchant_id で指定し、2) プラットフォーム事業者に請求するプラットフォーム手数料を submerchant_id と platform_fee で指定する必要があります。

   "platform_details": { 
      "processing_merchant": "submerchant_one",
      "submerchants": [
        {
          "submerchant_id": "submerchant_one",
          "platform_fee": "100",
          "amount": "700"
        }
      ]

capture が auto の場合、Session: Create API リクエスト時に platform_details 配列内で決済分割 (プラットフォーム事業者への金額とプラットフォーム手数料) を指定する必要があります。

Session: Create のリクエストで capture が manual の場合、注文を確実に履行するために、後で Payment: Capture をリクエストする必要があります。その際、platform_details 配列内で決済分割を指定する必要があります。

2 段階キャプチャ

(1) 承認

クレジットカードによる決済に関しては、加盟店は Payment API の capture パラメータを使用して決済がすぐに承認されるか、入金されるかを決定できます。これは、capture: false を指定することで達成できます。プラットフォーム分割は承認時に提供されず、入金のステップで提供されます。加盟店が決済処理事業者でない場合でも、決済処理事業者を指定できます。

2 段階キャプチャの詳細については、こちらを参照してください。

curl https://komoju.com/api/v1/payments \
-u degica-mart-test: \
-X POST \
-H "Content-Type: application/json" \
-d '{
   "amount":"1000",
   "currency":"JPY",
   "fraud_details": {
       "customer_ip": "192.0.2.1",
       "customer_email": "test@example.com"
   },
   "payment_details":{
       "email":"test@example.com",
       "month":"01",
       "name":"Taro Yamada",
       "number":"4111111111111111",
       "type":"credit_card",
       "verification_value":"123",
       "year":"2025"
    },
   "capture":"false",
   "platform_details":{
       "processing_merchant_id":"submerchant_one"
    }
}'

(2) 入金

入金のステップで決済分割情報を提供する必要があります。プラットフォーム事業者への移行金額とプラットフォーム手数料の合計は、決済の入金額を超えてはなりません。

curl https://komoju.com/api/v1/payments/{PAYMENT_UUID}/capture \
-u degica-mart-test: \
-X POST \
-H "Content-Type: application/json" \
-d '{
   "amount":"1000",
   "platform_details": {
   "processing_merchant_id":"submerchant_one",
   "submerchants": [
        {
          "submerchant_id":"submerchant_one",
          "amount":"900",
          "platform_fee":"100",
      }
    ]
  }
}'

(3) 部分入金

決済手段が VISA/Mastercard、JCB/AMEX/Diners Club、PayPay、LINE Pay、メルペイの場合、部分入金がサポートされます。プラットフォーム分割の合計額は、部分入金の金額と一致する必要があります。また、KOMOJU は単一の部分入金のみをサポートしており、複数の部分入金はサポートしていません。

API 経由で直接決済を作成する場合 (Payment: Create)、VISA/Mastercard および JCB/AMEX/Diners Club のみが部分入金に対応しています。

一方、ホストページ (Session: Create) で決済を作成する場合、上記の 5 つの決済手段すべてが部分入金に対応します。

元の決済額が 1000 円だったとすると、次のように 500 円で部分入金できます。

curl https://komoju.com/api/v1/payments/{PAYMENT_UUID}/capture \
-u degica-mart-test: \
-X POST \
-H "Content-Type: application/json" \
-d '{
   "amount":"500",
   "platform_details":{
      "processing_merchant_id":"submerchant_one",
      "submerchants": [
          {
            "submerchant_id":"submerchant_one",
            "amount":"400",
            "platform_fee":"100"
        }
      ]
   }
}'

決済をキャンセルする

(1) API 経由で決済をキャンセルする

pending または authorized の状態の決済を Payment: Cancel API を使用してキャンセルできます。

(2) ダッシュボード経由で決済をキャンセルする

ダッシュボードを介して、プラットフォーム事業者に代わって、pending または authorized の状態にある決済をキャンセルできます。

取り消し返金を作成する

(1) 設定

取り消し返金では、決済入金の際の決済分割ロジックに基づいて、支払いが顧客に全額返金されます。
該当する決済手段: VISA/Mastercard、JCB/AMEX/Diners Club、PayPay、LINE Pay、メルペイ
加盟店の残高とプラットフォーム事業者の残高が、それぞれが担当する返金額よりも大きくなければなりません。そうでない場合、返金は処理されません。

(2) 決済資金フローのロジック

システムはプラットフォーム事業者のアカウントから資金を引き落とし、顧客の決済手段の口座に返金します。その後すぐに、システムは対応する返金額を加盟店のアカウントから引き落とし、プラットフォーム事業者のアカウントに移行します。

(3) API を経由して取り消し返金を作成する

取り消し返金を開始するには、Payment: Refund API をリクエストします。また、プラットフォームの詳細を省略すると、決済分割は自動的に取り消されます。

curl https://komoju.com/api/v1/payments/{PAYMENT_UUID}/refund \
-u degica-mart-test: \
-X POST \
-H "Content-Type: application/json" \
-d '{

}'

(4) ダッシュボードを経由して取り消し返金を作成する

ダッシュボードを介して、プラットフォーム事業者に代わって取り消し返金を実行できます。

取り消し返金リクエストを作成する

(1) 設定

取り消し返金のリクエストは、自動返金をサポートしていない決済手段に使用されます。また、返金の取り消しでは、決済入金の際の決済分割ロジックに基づいて、支払いが顧客に全額返金されます。
該当する決済手段: コンビニ、銀行振込、ペイジー
加盟店の残高とプラットフォーム事業者の残高が、それぞれが担当する返金額よりも大きくなければなりません。そうでない場合、返金は処理されません。
顧客が後で KOMOJU から返金を受け取れるよう、顧客の銀行口座情報を集めて KOMOJU に渡す必要があります。
KOMOJU は、プラットフォーム事業者からの取り消し返金リクエストの返金が 1 件成立するごとに 300 円の返金手数料を請求します。(参照)。
プラットフォーム事業者が決済入金の際に顧客から顧客手数料を請求した場合、include_payment_method_fee を介して返金するかどうかを指定できます。

(2) 決済資金フローのロジック

システムはプラットフォーム事業者のアカウントから資金を引き落とし、顧客の銀行口座に返金します。その後すぐに、システムは 1) プラットフォーム事業者から返金手数料を請求し、2) 加盟店のアカウントから対応する返金金額を引き落とし、プラットフォーム事業者のアカウントに移行します。

(3) API を経由して取り消し返金のリクエストを作成する

Payment: Refund Request API をリクエストして、顧客の銀行口座情報を添えて取り消し返金リクエストを開始することができます。

curl https://komoju.com/api/v1/payments/{PAYMENT_UUID}/refund_request \
-u degica-mart-test: \
-X POST \
-H "Content-Type: application/json" \
-d '{
   "include_payment_method_fee":"true",
   "customer_name":"ｶﾀｶﾅ",
   "bank_name":"青森銀行",
   "bank_code":"0117",
   "branch_name":"東京支店",
   "branch_number":"921",
   "account_type":"ordinary",
   "account_number":"1234567",
}'

(4) ダッシュボードを経由して取り消し返金リクエストを作成する

ダッシュボードを介して、プラットフォーム事業者に代わって取り消し返金リクエストを実行できます。

取り消し以外の返金を作成する

(1) 設定

以下の場合には、取り消し以外の返金を開始する必要があります。

決済入金時の決済分割ロジックに従わない全額払い戻しを開始する
部分返金を開始する

知っておくべきその他の重要なポイント:

返金額は元の決済金額を上回ることはできません。
該当する決済手段: VISA/Mastercard、JCB/AMEX/Diners Club、PayPay、LINE Pay、メルペイ
加盟店の残高とプラットフォーム事業者の残高が、それぞれが担当する返金額よりも大きくなければなりません。そうでない場合、返金は処理されません。

(2) 決済資金フローのロジック

API 経由で、加盟店とプラットフォーム事業者がそれぞれ払い戻す金額を指定する必要があります。次に、システムがプラットフォーム事業者のアカウントから資金を引き落とし、顧客の決済手段の口座に返金します。その後すぐに、システムは対応する返金額を加盟店のアカウントから引き落とし、プラットフォーム事業者のアカウントに移行します。

この例では、

1,000 円の決済が、決済の入金の際に 2 つに分割され、プラットフォーム事業者に 900 円、加盟店に 100 円が最初に支払われました。
その後、加盟店は取り消し以外の返金をリクエストし、プラットフォーム事業者から 850 円とプラットフォーム加盟店から 50 円の合計 900 円を顧客に対して返金すると指定します。

(3) API を経由して取り消し以外の返金を作成する

取り消し以外の返金は、Payment: Refund API をリクエストすることでのみ開始できます。手動によるエラーを防ぐため、ダッシュボードからは開始できません。

curl https://komoju.com/api/v1/payments/{PAYMENT_UUID}/refund \
-u degica-mart-test: \
-X POST \
-H "Content-Type: application/json" \
-d '{
   "amount":"900",
   "platform_details":{
      "processing_merchant_id":"submerchant_one",
      "submerchants": [
        {
          "submerchant_id":"submerchant_one",
          "amount':"850",
          "platform_fee":"50",
        }
      ]
    }
}'

取り消し以外の返金リクエストを作成する

(1) 設定

以下の場合には、取り消し以外の返金リクエストを開始する必要があります。

決済入金時の決済分割ロジックに従わない全額払い戻しを開始する
部分返金を開始する

知っておくべきその他の重要なポイント:

返金額は元の決済金額を上回ることはできません。
該当する決済手段: コンビニ、銀行振込、ペイジー
加盟店の残高とプラットフォーム事業者の残高が、それぞれが担当する返金額よりも大きくなければなりません。そうでない場合、返金は処理されません。
顧客が後で KOMOJU から返金を受け取れるよう、顧客の銀行口座情報を集めて KOMOJU に渡す必要があります。
KOMOJU は、プラットフォーム事業者からの取り消し以外の返金リクエストの返金が 1 件成立するごとに 300 円の返金手数料を請求します。(参照)。
プラットフォーム事業者が決済入金の際に顧客から顧客手数料を請求した場合、include_payment_method_fee を介して返金するかどうかを指定できます。

(2) 決済資金フローのロジック

API 経由で、加盟店とプラットフォーム事業者がそれぞれ払い戻す金額を指定する必要があります。次に、システムはプラットフォーム事業者のアカウントから資金を引き落とし、顧客の銀行口座に返金します。
その後すぐに、システムは対応する返金額を加盟店のアカウントから引き落とし、プラットフォーム事業者のアカウントに移行します。

この例では、

1,000 円の決済が、決済の入金の際に 2 つに分割され、プラットフォーム事業者に 900 円、加盟店に 100 円が最初に支払われました。
その後、加盟店は取り消し以外の返金リクエストをリクエストし、プラットフォーム事業者から 850 円とプラットフォーム加盟店から 50 円の合計 900 円を顧客に対して返金すると指定します。
KOMOJU はプラットフォーム事業者に返金手数料 300 円を請求します。

(3) API を経由して取り消し以外の返金リクエストを作成する

取り消し以外の返金は、Payment: Refund Request API を、顧客の銀行口座情報を添えてリクエストすることでのみ開始できます。手動によるエラーを防ぐため、ダッシュボードからは開始できません。

curl https://komoju.com/api/v1/payments/{PAYMENT_UUID}/refund_request \
-u degica-mart-test: \
-X POST \
-H "Content-Type: application/json" \
-d '{
   "amount":"900",
   "include_payment_method_fee":"true",
   "customer_name":"ｶﾀｶﾅ",
   "bank_name":"青森銀行",
   "bank_code":"0117",
   "branch_name":"東京支店",
   "branch_number":"921",
   "account_type":"ordinary",
   "account_number":"1234567",
   "platform_details":{
      "processing_merchant_id":"submerchant_one",
      "submerchants": [
        {
          "submerchant_id":"submerchant_one",
          "amount':"850",
          "platform_fee":"50",
      }
    ]
  }
}'

チャージバック

(1) 設定

カード発行会社が異議申し立てを認めた場合、KOMOJU はチャージバックを実行して全額を顧客に返金し、その金額をプラットフォーム事業者の残高から差し引きます。チャージバックは、プラットフォーム事業者の残高が十分にあるかどうかに関係なく実行されます。

(2) 決済資金フローのロジック

決済処理事業者であるプラットフォーム事業者が、チャージバック全体を請け負います。

トランザクションレコードタイプの概要

上記のすべてのアクションを基に、複数のタイプのレコードが生成されます。以下はその要約です。

レコードタイプ	説明	入金/出金
取引	プラットフォーム事業者のアカウントに入金された取引。	(1) プラットフォーム事業者: 入金
プラットフォーム手数料	加盟店がプラットフォーム事業者に請求する、入金ごとの手数料。	(1) 加盟店: 入金 (2) プラットフォーム事業者: 出金
決済手数料	KOMOJU がプラットフォーム事業者に請求する、入金ごとの手数料。決済手段によって料金が異なる場合があります。	(1) プラットフォーム事業者: 出金
決済手数料消費税	決済手数料の税金。日本では、決済手数料額の 10% です。	(1) プラットフォーム事業者: 出金
返金	プラットフォーム事業者が顧客に返金する金額。	(1) プラットフォーム事業者: 出金
プラットフォーム手数料返還	加盟店がプラットフォーム事業者に返却する手数料額。顧客に返金する共同責任とみなすことができます。	(1) 加盟店: 出金 (2) プラットフォーム事業者: 入金
顧客手数料返金	プラットフォーム事業者が顧客に返金する顧客手数料。	(1) プラットフォーム事業者: 出金
顧客手数料返金消費税	プラットフォーム事業者が顧客に返金する顧客手数料の税金。日本では、顧客手数料額の 10% です。	(1) プラットフォーム事業者: 出金
返金手数料	KOMOJU が取り消し返金リクエストまたは取り消し以外の返金リクエストを完了した後にプラットフォーム事業者に請求する手数料。	(1) プラットフォーム事業者: 出金
返金手数料消費税	返金手数料の税金。日本では、返金手数料の 10% です。	(1) プラットフォーム事業者: 出金
チャージバック	カード発行会社が異議申し立てを認めたためにプラットフォーム事業者が顧客に返金する金額。	(1) プラットフォーム事業者: 出金

販売者決済処理モデル (プラットフォーム向け)

決済を作成する

📘
取引の入金時の決済分割ロジックを指定する必要があります

2 段階キャプチャ

決済をキャンセルする

取り消し返金を作成する

取り消し返金リクエストを作成する

取り消し以外の返金を作成する

取り消し以外の返金リクエストを作成する

チャージバック

トランザクションレコードタイプの概要

決済を作成する

📘取引の入金時の決済分割ロジックを指定する必要があります

2 段階キャプチャ

決済をキャンセルする

取り消し返金を作成する

取り消し返金リクエストを作成する

取り消し以外の返金を作成する

取り消し以外の返金リクエストを作成する

チャージバック

トランザクションレコードタイプの概要

📘
取引の入金時の決済分割ロジックを指定する必要があります