はじめに

プラットフォーム加盟店は、API を通じて販売者/ユーザーごとに「プラットフォーム事業」アカウントを登録する必要があります。

主な前提条件:

1. プラットフォーム事業者アカウントの登録は、日本の法人様（法人および個人事業主の両方）のみ受け付けております。
2. KOMOJU から日本円で払い出しを受け取るには、日本の銀行口座をお持ちであることが条件となります。

1.プラットフォーム事業者アカウントを作成する

Merchant: Create をリクエストし、platform_role を seller に設定してプラットフォーム事業者アカウントを作成します。

curl -X POST https://komoju.com/api/v1/merchants \
-u <platform merchant secret key>: \
-d name='New Seller Merchant 1' \
-d platform_role="seller"

2.プラットフォーム事業者の live_application に必須フィールドを問い合わせる

前の手順で受け取ったプラットフォーム事業者の uuid を使用して、Live Application: Show API をリクエストします。

curl -X GET https://komoju.com/api/v1/live_application/{id}?locale=en \
-u platform_merchant_secret_key:

レスポンス例

{
    "merchant_id": "5td723eoi9txn8sj545ww2mv1",
    "status": "incomplete",
    "payments_enabled": false,
    "payouts_enabled": false,
    "requested_fields": [
        {
            "field_type": "phone_number",
            "field": "company_information.company_phone",
            "field_name": "Company Phone",
            "field_properties": {
                "minLength": 1,
                "pattern": "^([() \\-_+]*[0-9]){10}[() \\-_+0-9]*$"
            },
            "optional": false
        },
      	...
    ],
    "newly_requested_fields": [],
    "errored_fields": []
}

requested_fields 配列内に、プラットフォーム事業者に必要な情報が含まれています。フィールドの optional パラメータが false に設定されている場合、プラットフォーム事業者は関連情報を入力する必要があります。true に設定すると、対応する詳細がない場合はスキップできます。

各フィールドのプロパティの内訳は次のとおりです。

"field": "visa_mastercard_credit_card.access_restrictions",
"field_name": "Implemented (to be implemented)",
"field_description": "Restrict IP addresses accessible to administrators; if IP addresses cannot be restricted, set access restrictions such as basic authentication on the administrator screen.",
"field_type": "checkbox",
"field_properties": {}
"optional": false

• field は、そのフィールドの情報を送信するときに使用するプロパティ名です。
• field_name は、ユーザーに表示される、ローカライズされたフィールドの名前です。
• field_description は、フィールドが何を要求しているかについてのローカライズされた説明文です
• field_type は、表示されるコンポーネントのタイプです。
• field_properties には、フィールドの値の制限事項に関する情報が含まれています。
• optional はフィールドが必須かどうかを表します。

(1) field_types

異なる field_types は、ユーザーに表示されるフォーム コンポーネントのタイプを指示して、期待される値の区別と書式設定を支援するためのものです。

(2) field_properties

field_properties は、フィールドのプロパティに関する情報を提供します。

3.事業者のファイルをアップロードする

一部の field_type (single_file_upload、file_upload) では、まず事業者ファイル API 経由でファイルをアップロードし、次に UUID を live_application の値として送信する必要があります。

プラットフォーム事業者のオンボーディング用のファイルをアップロードするには、File: Create API をリクエストします。

アップロードできる形式は jpg、png、pdf のみです。また、各ファイルのサイズの上限は 10 MB です。

curl -X POST https://komoju.com/api/v1/merchants/{id}/files \
  -u platform_merchant_secret_key: \
  -F "paper=/path/to/file"

レスポンスは次のようになります。

{
    "id": "6ssx1zxovw3fgmdsdd1zuzr5u",
    "resource": "file",
    "filename": "blank.png",
    "size": 998,
    "mime_type": "image/png",
    "created_at": "2023-01-10T12:16:00.819+09:00",
    "updated_at": "2023-01-10T12:16:01.085+09:00"
}

4.送信フィールド

ステップ 2で受信した requested_fields に基づいて、 Live Application: Update API を介してプラットフォーム事業者に情報を送信できるようになりました。

次の例では、company_information.company_name を送信しています。

curl -X PATCH https://komoju.com/api/v1/live_application/{id} \
  -u platform_merchant_secret_key: \
  -d "company_information.company_name=My Company"

成功した場合、レスポンスには、送信された内容に基づいて必要となった追加フィールドが含まれます。company_name の場合、値 company_name に依存する追加フ​​ィールドがないため、newly_requested_fields は空白になります。

newly_requested_fields の例

company_information.corporation_type を sole_proprietor として送信した場合

curl -X PATCH https://komoju.com/api/v1/live_application/{id} \
  -u platform_merchant_secret_key: \
  -d "company_information.corporation_type=sole_proprietor"

レスポンスで、newly_requested_fields に sole_proprietor_proofs が含まれているのがわかります。

"newly_required_fields": [
      {
          "field": "company_information.sole_proprietor_proofs",
          "field_name": "Sole proprietor proofs",
          "field_type": "file_upload",
          "field_properties": {}
      }
  ]

newly_requested_fields は update 時にのみ表示され、live_application への最後の更新の結果としてフォームに追加される新しいフィールドを返します。

複数の値を許可するフィールドの場合 (multi_select, file_upload field_types)

値の配列を送信します。

curl -X PATCH https://komoju.com/api/v1/live_application/{id} \
  -u platform_merchant_secret_key: \
  -d '{
    "visa_mastercard_credit_card.countermeasures_during_card_registration": 
      [ "access_restrictions_during_card_registration"]
  }'

5.Live アプリケーションを完了する

必要な情報は、事業者の種類（例: 法人、個人事業主など）によって異なる場合があります。当社の API レスポンスは、必要に応じて requested_fields 配列と newly_requested_fields 配列にフィールドを追加しながら、オンボーディング プロセス全体をガイドします。

Live アプリケーションは、required_fields、newly_required_fields、errored_fields がすべて空白になるまで入力し続ける必要があります。この段階では、アプリケーションのステータス フィールドは pending に設定する必要があります。

必要な情報は通常、以下の 5 つのカテゴリに分類されます。

(1) KOMOJU サービス利用規約の承諾

Platform Model サービスを販売者に提供するために、KOMOJU は販売者と直接の契約関係を確立する必要があります。これには、各プラットフォーム事業者アカウントが KOMOJU 加盟店サービス利用規約およびプライバシーポリシーに同意する必要があります。プラットフォーム加盟店には、インターフェース経由で登録する際に販売者がこれらの条件に同意することを保証する責任があります。

KOMOJU サービス利用規約の参照

少なくとも、オンボーディング プロセスを開始するときに、販売者に正しい利用規約へのリンクを示し、明示的な同意を得る必要があります。推奨されるプロセスは以下のとおりです。

1. Live Application: Show API をリクエストして、`service_agreement.agreed_to_tos' フィールドから KOMOJU加盟店サービス利用規約 と プライバシーポリシー の URL を取得します。
2. 販売者がサービスへのオプトインを開始するときに、プラットフォーム上の販売者にこの規約を提示します。
3. 販売者の同意を Live Application: Update API 経由で送信できます。

次の例では、インターフェイスを介して貴社のユーザーに KOMOJU の規約を提示する方法を示しています。

(2) 企業情報

以下に、登録に必要な会社関連情報の詳細一覧を示します。

(3) 個人情報

代表取締役および申請者に関する必須情報をまとめた一覧を以下に示します。

法人向け:

• 代表取締役と申請者は同一人物でもかまいません。
• 申請者は、法人契約に関する決定権を有する人物でなければなりません。

個人事業主の場合:

• 代表取締役と申請者が同一人物の場合は、representative_director のフィールドに入力してください。

(4) サイト情報

以下は、Web サイトに関連する必須情報です。

• 店舗住所は、特定商取引法に基づく表記の URL をホストするウェブサイトに記載されている住所と一致している必要があります。

(5) 銀行口座情報

必要な銀行口座情報は以下になります。

法人向け:

• 銀行口座は申請法人と同一名義の口座のみ登録可能です。

個人事業主の場合:

• 銀行口座は代表者名または社名名義の口座のみ登録可能です。

続行する前に、このガイド を読んで、銀行口座情報が正しく入力されていることを確認してください。

❗️

払い出しが遅れる可能性があります

口座名義人名が間違っている場合、払い出しの受け取りが遅れる可能性があります。銀行通帳に記載されている半角カナ名を正確に入力してください。

6.送信した情報を確認する

送信したすべての情報を確認するには、Live Application: Show を再度リクエストしてください。submitted_fields 配列には、すでに送信した情報が表示されます。

7.Webhook を設定する

Webhook を設定してイベントにサブスクライブし、プラットフォーム事業者のアプリケーションのレビュー状況が更新されたときに通知を受け取れます。

• プラットフォーム モデルの Webhook イベントの詳細につきましては、こちらをご参照ください。

8.プラットフォーム事業者の選択中の決済手段を指定する

📘

選択中の決済手段は、利用可能な決済手段からのみ選択できます

選択中の決済手段として選択できるのは、利用可能な決済手段に記載されている決済手段のみであることに注意してください。詳細はこちら をご参照ください。

プラットフォーム事業者が使用する予定の決済手段を申請する必要があります。申請可能な決済手段を確認するには、Live Application: Payment Methods APIを使用します。この API は以下を返します。

curl -X GET https://komoju.com/api/v1/live_application/{id}/payment_methods \
  -u platform_merchant_secret_key: \

• submitted_payment_methods 一覧ラットフォーム事業者が申請した決済手段を一覧として表示します。
• unsubmitted_payment_methods 一覧用可能なもののプラットフォーム事業者がまだ申請していない決済手段が一覧として表示されます。

特定の決済手段を申請するには、Live Application: Update Payment Method API をリクエストします。

各決済手段の申請時の詳細は以下の通りです。

(1) VISA/MasterCard

決済手段: visa_mastercard_credit_card

法人および個人事業主に対応。

クレジットカード決済では、3-D Secure 2.0認証が標準で導入されます。ただし、KOMOJUの導入方法によっては3-D Secure 2.0をご利用いただけない場合があります。3DSecure2についてはこちらをご覧ください。

クレジットカード決済を有効にするため、以下の情報を入力してください。

第1段階のアンケート:

第2段階のアンケート:: セキュリティ対策措置に関する申告について

KOMOJUでは、経済産業省および日本クレジット協会等からの要請に基づき、新たにクレジットカード決済の導入を予定されているEC加盟店様に対して、クレジット取引セキュリティ対策協議会が策定した「セキュリティ・チェックリスト」に基づいた、セキュリティ対策措置の実施状況を申告頂きたく、ご案内申し上げます。

「セキュリティ・チェックリスト」は、経済産業省が公表した「クレジットカード・セキュリティガイドライン（4.0版）」に定める基本的なセキュリティ対策を網羅した内容となっております。今回、クレジットカード決済をお申し込みの加盟店様には、次頁に挙げるセキュリティ対策措置について申告いただくと共にセキュリティ対策措置の実施・継続をお約束頂きたく存じます。上記チェックリストに基づく対策をお約束頂けない場合は、契約をするべきでないというご指導を頂いています。

お手数ですが、ご協力の程よろしくお願いいたします。

KOMOJUのクレジットカード決済導入予定の加盟店は以下のセキュリティ対策措置の実施状況についてご回答ください。
なお、契約締結時には、未充足の場合でも、契約いただけますが、決済開始時に全項目を充足することをお約束いただく必要があります。

1. 管理者画面のアクセス制限不備と管理者のID/PW管理不足への対策

2. データディレクトリの露見に伴う設定不備への対策

3. 脆弱性診断またはペネトレーションテストの定期実施、およびWebアプリケーションの脆弱性への対策

4. マルウェア対策としてのウイルス対策ソフトの導入、運用の実施

5. 悪質な有効性確認、クレジットマスターへの対策

6. 不正ログイン対策

7. visa_mastercard_credit_card.have_countermeasures_against_unauthorized_login に true と回答した場合御社システムにおいて実装している不正ログイン対策についてご回答ください。（日本クレジット協会のルールにより、会員登録、会員ログイン認証、ユーザ属性情報変更の各場面において、以下に記載の対策のうち、それぞれ１つ以上の実装が必須とされています。）

• access_restrictions_during_card_registration: 不審なIP アドレスからのアクセス制限
• mfa_implementation_during_card_registration: 二要素認証等による本人確認
• user_information_validation_during_card_registration: 会員登録時の個人情報確認
• fraud_detection_system_during_card_registration: 不正検知システム（Fraud サービス）

• access_restrictions_during_authentication: 不審なIP アドレスからのアクセス制限
• mfa_implementation_during_authentication: 二要素認証等による本人確認
• login_attempt_restriction_during_authentication: ログイン試行回数の制限強化 （アカウントパスワードクラッキングの対応）
• login_notification_during_authentication: ログイン時のメールやSMS通知、 スロットリング等
• device_fingerprint_during_authentication: デバイスフィンガープリント等

• access_restrictions_during_user_data_modification: 不審なIP アドレスからのアクセス制限
• mfa_implementation_during_user_data_modification: 二要素認証等による本人確認
• fraud_detection_system_during_user_data_modification: 不正検知システム（Fraud サービス）

(2) JCB/AMEX/Diners (Japan)

決済手段: jcb_amex_diners_credit_card

法人および個人事業主に対応。

クレジットカード決済では、3-D Secure 2.0認証が標準で導入されます。ただし、KOMOJUの導入方法によっては3-D Secure 2.0をご利用いただけない場合があります。3DSecure2についてはこちらをご覧ください。

クレジットカード決済を有効にするため、以下の情報を入力してください。

第1段階のアンケート:

第2段階のアンケート:: セキュリティ対策措置に関する申告について

KOMOJUでは、経済産業省および日本クレジット協会等からの要請に基づき、新たにクレジットカード決済の導入を予定されているEC加盟店様に対して、クレジット取引セキュリティ対策協議会が策定した「セキュリティ・チェックリスト」に基づいた、セキュリティ対策措置の実施状況を申告頂きたく、ご案内申し上げます。

「セキュリティ・チェックリスト」は、経済産業省が公表した「クレジットカード・セキュリティガイドライン（4.0版）」に定める基本的なセキュリティ対策を網羅した内容となっております。今回、クレジットカード決済をお申し込みの加盟店様には、次頁に挙げるセキュリティ対策措置について申告いただくと共にセキュリティ対策措置の実施・継続をお約束頂きたく存じます。上記チェックリストに基づく対策をお約束頂けない場合は、契約をするべきでないというご指導を頂いています。

お手数ですが、ご協力の程よろしくお願いいたします。

KOMOJUのクレジットカード決済導入予定の加盟店は以下のセキュリティ対策措置の実施状況についてご回答ください。
なお、契約締結時には、未充足の場合でも、契約いただけますが、決済開始時に全項目を充足することをお約束いただく必要があります。

1. 管理者画面のアクセス制限不備と管理者のID/PW管理不足への対策

2. データディレクトリの露見に伴う設定不備への対策

3. 脆弱性診断またはペネトレーションテストの定期実施、およびWebアプリケーションの脆弱性への対策

4. マルウェア対策としてのウイルス対策ソフトの導入、運用の実施

5. 悪質な有効性確認、クレジットマスターへの対策

6. 不正ログイン対策

7. jcb_amex_diners_credit_card.have_countermeasures_against_unauthorized_login に true と回答した場合御社システムにおいて実装している不正ログイン対策についてご回答ください。（日本クレジット協会のルールにより、会員登録、会員ログイン認証、ユーザ属性情報変更の各場面において、以下に記載の対策のうち、それぞれ１つ以上の実装が必須とされています。）

• access_restrictions_during_card_registration: 不審なIP アドレスからのアクセス制限
• mfa_implementation_during_card_registration: 二要素認証等による本人確認
• user_information_validation_during_card_registration: 会員登録時の個人情報確認
• fraud_detection_system_during_card_registration: 不正検知システム（Fraud サービス）

• access_restrictions_during_authentication: 不審なIP アドレスからのアクセス制限
• mfa_implementation_during_authentication: 二要素認証等による本人確認
• login_attempt_restriction_during_authentication: ログイン試行回数の制限強化 （アカウントパスワードクラッキングの対応）
• login_notification_during_authentication: ログイン時のメールやSMS通知、 スロットリング等
• device_fingerprint_during_authentication: デバイスフィンガープリント等

• access_restrictions_during_user_data_modification: 不審なIP アドレスからのアクセス制限
• mfa_implementation_during_user_data_modification: 二要素認証等による本人確認
• fraud_detection_system_during_user_data_modification: 不正検知システム（Fraud サービス）

(3) PayPay

決済手段: paypay

法人および個人事業主に対応。

PayPay を申請する際に必要な情報は以下の通りです：

(4) メルペイ

決済手段: merpay

法人のみ利用可能です。

メルペイ を申請する際に必要な情報は以下の通りです：

(5) 銀行振込

決済手段: bank_transfer

法人および個人事業主に対応。

銀行振込を申請する際には追加情報は不要です。

(6) ペイジー(Pay-easy)

決済手段: pay_easy

法人および個人事業主に対応。

ペイジーを申請する際には追加情報は不要です。

(7) コンビニ決済

決済手段: convenience_store

法人および個人事業主に対応。

コンビニ決済を申請する際に必要な情報は以下の通りです：

(8) セブン‐イレブン

決済手段: seven_eleven

法人のみ利用可能です。

セブン‐イレブン決済は、セブン‐イレブンが定めるレギュレーションに沿ったサイト・運用であるかの審査がございます。導入をご希望の場合は、以下の項目すべてに対応しているかをご確認いただき、回答後、「送信」をお願いいたします。すべての項目に対応出来ない場合は、セブン‐イレブン決済の提供は承認されません。

フォームの受信後、セブン‐イレブン・ジャパンへ審査の申請をいたします。
審査期間：申請後1～2ヶ月程度

審査途中、個別にセブン‐イレブンからの確認や指摘が入る場合がございます。KOMOJUサポートチームよりご連絡いたしますので、ご対応いただきますようお願いいたします。

セブン‐イレブンを申請する際に必要な情報は以下の通りです：

9.(テスト環境のみ) Live 申請のステータスをシミュレートする

事業者の申請と選択中の決済手段の申請が完了すれば、KOMOJU の審査結果をシミュレートできます。

(1) 事業者の申請状況をシミュレートする

Live Application: Simulate Status API をリクエストして、事業者のアプリケーションが accepted または declined のどちらになるかをシミュレートします。

(2) 選択中の決済手段の申請ステータスをシミュレートする

Live Application: Simulate Payment Method Status API をリクエストして、選択中の決済手段の申請ステータス（accepted または declined）をシミュレートします。