はじめに

「プラットフォーム加盟店」事業者として、プラットフォーム向けを導入するには、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 に必須フィールドを問い合わせる

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

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,
    "required_fields": [
        {
            "field": "company_information.company_phone",
            "field_name": "Company Phone",
            "field_type": "phone_number",
            "field_properties": {
                "minLength": 1,
                "pattern": "^([() \\-_+]*[0-9]){10}[() \\-_+0-9]*$"
            }
        },
				...
    ],
    "newly_required_fields": [],
    "errored_fields": []
}

required_fields 配列内で、プラットフォーム事業者の登録を進めるためにどのような情報が必要か確認できます。各フィールドのプロパティの内訳は次のとおりです。

"field": "company_information.company_phone",
"field_name": "Company Phone",
"field_type": "phone_number",
"field_properties": {
  "minLength": 1,
  "pattern": "^([() \\-_+]*[0-9]){10}[() \\-_+0-9]*$"
}

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

(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 で受け取った required_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_required_fields は空白になります。

newly_required_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_required_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_required_fields は update 時にのみ表示され、live_application への最後の更新の結果としてフォームに追加される新しいフィールドを返します。

複数の値を許可するフィールド（multi_select、file_upload フィールドタイプ）に関して

Arrayの値を送信してください。

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_application の完了

必要な情報はユーザーの状況 (法人、個人事業主など) に応じて異なる可能性があるため、API レスポンスでは、required_fields 配列と newly_required_fields 配列の下に追加のフィールドを提供することで、オンボーディングフロー全体をステップごとにガイドします。

live_application フィールドは、required_fields、newly_required_fields、errored_fields がすべて空白になるまで入力し続ける必要があります。その時点で、申請が完了したとみなされます。

必要な情報は大きく 5 つのカテゴリーに分かれており、それぞれのカテゴリーで大まかな項目を確認できます。

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

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

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

最低条件として、オンボーディングプロセスを開始する際に、正しい規約へのリンクを販売者に提示し、その規約に明示的に同意してもらう必要があります。推奨される手順は次のとおりです。

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

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

(2) 企業情報

以下は、会社関連の必須情報をまとめたリストです。

(3) 個人情報

以下は代表取締役および申請者に関する必須情報をまとめたリストです。

法人の場合:

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

個人事業主の場合:

• 代表取締役と申請者が同一人物の場合は、representative_director に関する項目のみ入力してください。

(4) サイト情報

以下は、サイト関連の必須情報をまとめたリストです。

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

(5) 銀行口座情報

以下は、銀行口座関連の必須情報をまとめたリストです。

• 法人の場合は、お申込みいただいた法人名義のみ口座登録が可能です。個人事業主の場合は、代表者名または屋号のみで口座を登録できます。
• 銀行口座情報を正しく入力するために、まずこちらのガイドをお読みください。

❗️

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

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

6.送信した情報の確認

Liveapplication: Show をもう一度クエリすると、送信したすべての情報を submitted_fields 配列で確認できます。その際、以前提出した情報 (ある場合) も表示されます。

7.Webhook を設定する

Webhook を設定してイベントにサブスクライブすると、プラットフォーム事業者の申請の審査ステータスが更新された直後に通知を受け取ることができます。

• Platform Model の Webhook イベントの詳細はこちら

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

📘

利用可能な決済手段により、すべてのプラットフォーム事業者が利用できる選択中の決済手段を指定します。

なお、プラットフォーム事業者の選択中の決済手段に指定できるのは、利用可能な決済手段に含まれる決済手段のみです。詳細については、こちらを参照してください。

この段階では、プラットフォーム事業者が導入したい決済手段をプラットフォーム事業者に代わって申請する必要があります。まず、submitted_pa​​yment_methods と unsubmitted_pa​​yment_methodsで該当するすべての決済手段を確認するために、Live Application: Payment Methods 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. 御社システムにおいて実装している不正ログイン対策についてご回答ください。（日本クレジット協会のルールにより、会員登録、会員ログイン認証、ユーザ属性情報変更の各場面において、以下に記載の対策のうち、それぞれ１つ以上の実装が必須とされています。）

(1) 質問: 会員登録時（クレジットカード番号登録時）に不正利用対策として有効な対策を実装していればチェックしてください。

• 選択: 以下のうち一つまたは複数を選択できます

(2) 質問: 会員登録後のログイン認証時に不正ログイン対策として有効な対策を実装していればチェックしてください。

• 選択: 以下のうち一つまたは複数を選択できます

(3) 質問: ログイン後に会員属性（氏名、住所、メールアドレス等）の変更時に不正利用対策として有効な対策を実装していればチェックしてください。

• 選択: 以下のうち一つまたは複数を選択できます

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

(1) 質問: 会員登録時（クレジットカード番号登録時）に不正利用対策として有効な対策を実装していればチェックしてください。

• 選択: 以下のうち一つまたは複数を選択できます

(2) 質問: 会員登録後のログイン認証時に不正ログイン対策として有効な対策を実装していればチェックしてください。

• 選択: 以下のうち一つまたは複数を選択できます

(3) 質問: ログイン後に会員属性（氏名、住所、メールアドレス等）の変更時に不正利用対策として有効な対策を実装していればチェックしてください。

• 選択: 以下のうち一つまたは複数を選択できます

(3) PayPay

決済手段: paypay

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

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

(4) LINE Pay

決済手段: linepay

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

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

(5) メルペイ

決済手段: merpay

法人のみ利用可能です。

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

(6) 銀行振込

決済手段: bank_transfer

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

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

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

決済手段: pay_easy

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

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

(8) コンビニ決済

決済手段: convenience_store

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

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

(9) セブン‐イレブン

決済手段: seven_eleven

法人のみ利用可能です。

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

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

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

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