KOMOJU 決済方法の設定
KOMOJUは、日本国内で広く利用されているオンライン決済サービスで、クレジットカードやコンビニ払い、電子マネーなど多様な決済手段を一括して導入できるプラットフォームです。
SHOPLINEではKOMOJUとの連携を通じて、日本や海外の消費者に馴染みのある支払い方法を簡単に提供できます。
対応範囲と利用条件
- 対象：日本国内の銀行口座をお持ちの法人または個人事業主
- 決済通貨：日本円
- 振込通貨：日本円
- 審査：KOMOJUによる事業者審査が必要
- 入金サイクル：月次、または週次
- 対応している支払い方法：クレジットカードに加えて、「設定」→「決済」→「その他の決済方法」→「決済方法の追加」から、KOMOJUを検索して決済方法をご確認ください。
|
ご注意： KOMOJUはさまざまな決済方法を提供していますが、すべての方法がSHOPLINEと連携しているわけではないため、最新の対応決済方法は上記の方法でご確認ください。 |
KOMOJUアカウントの連携方法
事前準備
KOMOJU連携を行う前に、以下を準備してください。
- 有料プラン利用中のSHOPLINEアカウント
- Liveモード利用可能なKOMOJUアカウント（Liveモード申請方法については、KOMOJUのFAQ記事をご参照ください。）
|
ヒント：
|
接続手順
- SHOPLINEの管理画面にログインします。
- 画面左下の［設定］＞［決済］を選択します。
- ［クレジットカード・デビットカード決済］の［サービスプロバイダーの選択］ボタンをクリックします。
クレジットカード以外の決済方法を接続する場合は、「その他の決済方法」を選択してください。
- KOMOJU管理画面で「Liveモード」に切り替えた後、「非公開鍵」と「公開鍵」をそれぞれコピーし、SHOPLINEの管理画面に貼り付けた後、利用予定の支払い方法にチェックを入れて、保存してください。
選択した決済方法が、KOMOJU管理画面で有効にしている決済方法と一致していることを確認してください。
|
ご注意： KOMOJUには【テストモード】と【Liveモード（本番環境）】が用意されており、本番環境は申請を提出し、審査を通過した後にのみ利用できます。Liveモードとテストモードでは公開鍵および非公開鍵が異なりますので、連携の際は必ず「Liveモード」の値を使用していることをご確認ください。そうでない場合、購入者が決済を完了できなくなります。 |
Webhookの設定
KOMOJUの支払いステータスや返金ステータスを即時に受け取るためには、KOMOJU管理画面でWebhookの設定を行う必要があります。以下に、クレジットカード決済およびその他の決済方法の設定方法をそれぞれ紹介します。
クレジットカードの場合
KOMOJU管理画面の［各種情報］＞ ［Webhook］＞ ［新規Webhook］よりWebhookの設定を行ってください。
-
Webhook URL：下記のURLをコピーし、Webhook URLの入力ボックスにペーストしてください。
- シークレットキー：KOMOJU管理画面の［設定］＞［公開鍵］をコピーし、シークレットキーの入力ボックスにペーストしてください。
- ［イベント］＞［ペイメント］：イベント名のステータスをすべて有効にしてください。
その他の決済方法の場合
KOMOJU管理画面の［各種情報］＞ ［Webhook］＞［新規Webhook］よりWebhookの設定を行ってください。
-
Webhook URL：下記のURLをコピーし、Webhook URLの入力ボックスにペーストしてください。
- シークレットキー：KOMOJU管理画面の［設定］＞［公開鍵］をコピーし、シークレットキーの入力ボックスにペーストしてください。
- ［イベント］＞［ペイメント］：イベント名のステータスをすべて有効にしてください。
|
ご注意： KOMOJUではTestモードとLiveモードが提供されていますが、SHOPLINE側ではテスト環境と本番環境が区別されていません。注文が成立するとサービス利用料が発生するため、決済プロセスをテストする場合は、できるだけ低価格の商品を使用して行うことをおすすめします。 |
KOMOJUを利用した返金手続き
KOMOJU と SHOPLINE はシステム連携しており、SHOPLINE 上で注文内容を変更した場合、通常は KOMOJU 側にも自動で反映されます。ただし、支払い方法によって返金の手続きが異なりますので、ご注意ください。
コンビニ決済、銀行振込、ペイジー決済などの場合
お客様の銀行口座情報をご確認のうえ、KOMOJUおよびSHOPLINEの管理画面から返金手続きを行う必要があります。KOMOJU経由でコンビニ、銀行振込などを返金する流れは、こちらの記事をご参照ください。
| ご注意：銀行振込・コンビニ・ペイジーを KOMOJU 経由で返金する場合、返金処理ごとに 300 円の手数料が発生します。 |
上記以外の決済方法の場合
クレジットカード、スマホ決済、ペイディ、キャリア決済、楽天ペイなどの全額・一部返金の操作は、SHOPLINE 管理画面の注文詳細ページにて行ってください。
KOMOJU上で返金を行う時に、ご質問がある場合、KOMOJUの関連ページをご参照ください。
よくある決済エラーおよび対処法
支払い・返金処理の際に、予期せぬエラーが発生する場合があります。
SHOPLINE の管理画面にエラーが表示された場合は、まず下記の表にて原因およびお問い合わせ先をご確認いただくと、スムーズに対応いただけます。
| エラーコード | エラーメッセージ | 問い合わせ先 |
| bad_request | The server cannot or will not process the request due to something that is perceived to be a client error. | KOMOJU側 |
| unauthorized | User authorization failed. | KOMOJU側 |
| not_found | The requested resource could not be found but may be available again in the future. | KOMOJU側 |
| internal_server_error | We're sorry but something went wrong. Please try your request again. | KOMOJU側 |
| forbidden | You are not authorized to perform that action. | KOMOJU側 |
| unprocessable_entity | The request was well-formed but was unable to be followed due to semantic errors. | KOMOJU側 |
| bad_gateway | We are unable to process your request due to an invalid response from the upstream server. | KOMOJU側 |
| gateway_timeout | When attempting to process your payment, we encountered a gateway timeout. Fear not, we have not processed the payment. Please try your payment again. | KOMOJU側 |
| service_unavailable | The server is down for maintenance. Please try again later. | KOMOJU側 |
| request_failed | The request failed | SHOPLINE側 |
| invalid_payment_type | Payment method was invalid. %{provided} is not one of %{allowed}. | SHOPLINE側 |
| invalid_token | The token you requested is invalid | SHOPLINE側 |
| invalid_currency | The currency you requested is invalid. | SHOPLINE側 |
| not_refundable | The payment you requested is not refundable. | KOMOJU側 |
| not_capturable | The payment you requested is not capturable. | KOMOJU側 |
| not_cancellable | This payment is noncancellable. | KOMOJU側 |
| not_chargebackable | The payment is not chargebackable. | KOMOJU側 |
| fraudulent | This payment is fraudulent. | 購入者側 |
| invalid_parameter | The value of %{param} is invalid | SHOPLINE端 |
| missing_parameter | A required parameter (%{param}) is missing | SHOPLINE端 |
| insufficient_funds | Insufficient funds | 購入者側 |
| used_number | Used number | 購入者側 |
| card_declined | Card declined | 購入者側 |
| invalid_password | Invalid password | 購入者側 |
| bad_verification_value | Bad verification value | 購入者側 |
| exceeds_limit | Exceeds limit | 購入者側 |
| card_expired | Card expired | 購入者側 |
| invalid_number | The number you requested is invalid. | 購入者側 |
| invalid_account | Invalid account | 購入者側 |
| restricted_account | Restricted account | 購入者側 |
| other_error | Other error | KOMOJU端 |
| invalid_user_key | Invalid user key | KOMOJU端 |
| other_invalid | Invalid card | 購入者側 |
よくある質問（FAQ）
Q1. KOMOJU は他の決済サービスと併用できますか？
A. はい、併用可能です。ただし、複数の決済サービス（例：ペイジェント／Stripe）で同じ決済手段を同時に有効化すると、購入者が混乱する可能性があります。同一手段の重複有効化は避けてください。
Q2. 支払い完了後、入金情報が SHOPLINE に反映されるまでどのくらい時間がかかりますか？
A. Webhook の設定が完了している場合、原則リアルタイムで SHOPLINE に反映されます。
Q3. 返金が失敗するのはなぜですか？
A. 返金失敗にはさまざまな原因がありますが、まずは KOMOJU 側の残高不足がないかご確認ください。直前に入金処理が行われ、返金に必要な残高が不足している場合があります。
その他の原因は上記「エラーコード一覧」をご参照のうえ、記載の窓口へお問い合わせください。
Q4. コンビニ払いなど、個別の支払い方式の支払期限を変更できますか？
A. はい、可能です。KOMOJU 側の管理画面にて設定してください。
Q5. KOMOJU の決済手数料はどのように請求されますか？
A. 決済手数料は入金時に自動で差し引かれます。入金される金額は、手数料控除後の純額となります。