ShopifyにおけるKOMOJU注文・決済の仕組み

概要

このガイドでは、Shopifyの「注文」とKOMOJUの「決済」の対応関係について解説します。決済IDを用いて、両システム間で注文と決済がどのように1対1で紐づいているのか、その仕組みについてご確認いただけます。

また、両プラットフォームでの決済情報の確認手順をはじめ、決済ステータスの変化が各システムの表示にどう影響するか、さらには「保留中の決済がKOMOJUにのみ表示される理由」といった実践的な内容もあわせて説明します。

本ガイドを通して、2つのシステム間をスムーズに行き来し、決済データが同期される仕組みをより明確にご理解いただけます。

前提条件

✅

「ShopifyでKOMOJUをはじめる」（本シリーズのPart 1）をご一読いただいていること

KOMOJUおよびShopify、両プラットフォームの基本的な操作方法をご理解いただいていること

注文と決済の関係性について

本連携における基本的な概念は、「Shopifyが『注文』を管理し、KOMOJUが『決済』を管理する」という役割分担にあります。原則として、1つのShopifyの注文に対して、1つのKOMOJU決済IDが1対1で紐づきます。

この連携において、各プラットフォームは以下の情報を管理します。

Shopify： 購入商品、配送先情報、注文の合計金額、フルフィルメント（発送処理）といった「注文レベル」の情報
KOMOJU： 決済方法の選択や実際の決済処理といった「決済レベル」の情報

KOMOJUを通じて決済のオーソリ（認証）または売上確定（入金済み）が行われると、Shopify側の注文タイムライン上にKOMOJUの決済IDが表示され、その後の決済ステータスの更新も順次反映されていきます。また、KOMOJU管理画面の決済詳細ページでは、KOMOJUの決済IDとShopifyのオーダーID（注文番号）の両方をご確認いただけます。

⚠️
保留中状態の決済は、KOMOJU側には即座に表示されますが、決済のオーソリ（認証）が完了するまではShopify側の注文タイムラインには反映されません。

ShopifyとKOMOJUでのIDの確認・検索方法

Shopifyのタイムラインで確認する

Shopify上で注文の決済情報を確認するには、注文詳細ページの「タイムライン」セクションを参照します。ここは、マーチャントが注文処理を行う際に決済の進行状況を確認するための重要な領域です。

決済処理が進むにつれて（例：オーソリから入金済みへの移行など）、そのステータスの変化はKOMOJU側から自動的に同期され、常に最新の決済状態がタイムラインに反映されます。タイムラインの履歴にはKOMOJUの決済IDが直接表示されており、このIDをもとにKOMOJU管理画面でより詳細な情報を確認することができます。

KOMOJU管理画面で検索する

逆に、KOMOJU管理画面から特定のShopify注文に紐づく決済情報を探す場合は、「取引」画面を使用します。画面内の「詳細条件」を開き、「オーダーID」の項目にShopifyのオーダーIDを入力して検索してください。

ℹ️
Shopifyのタイムライン上にKOMOJUに関する履歴が複数表示されている場合は、一番下（一番最初）にある、タイプが「authorization」または「sale」と記載されているエントリをご参照ください。

注文のライフサイクルと決済ステータス

KOMOJUにはいくつかの決済ステータスが存在しますが、その中の「保留中」は、お客様（購入者）がまだチェックアウト手続きを完了していない状態を指します。

この保留中状態の間、該当の決済データはKOMOJUの管理画面にのみ作成され、Shopifyの注文画面やタイムラインには反映されません。これは、実際の決済処理（オーソリ等）が完了するまで、KOMOJUからShopifyへステータス更新の通知が行われない仕様となっているためです。

決済が「保留中」から次のステータス（オーソリ完了や入金済みなど）へ移行すると、Shopifyのタイムラインにもデータが反映され、以降は両方のシステムで決済情報を確認できるようになります。

⚠️
Shopify上で直近の注文や決済が見当たらない場合は、まずはKOMOJU管理画面をご確認ください。決済がまだ「保留中」状態のままになっている可能性があります。

システム連携における留意点

本連携において特にご注意いただきたい点として、「決済セッションの有効期限」の仕様が挙げられます。ShopifyとKOMOJUはそれぞれ独立して有効期限を管理しており、この仕組みをご理解いただくことで、予期せぬステータス同期のエラーを防ぐことができます。

Shopifyの有効期限： 注文作成から72時間、注文セッションが有効な状態に保たれます。この期間内に決済が完了（オーソリ等）しなかった場合、Shopifyは自動的にその注文を期限切れ（キャンセル）として処理します。
KOMOJUの有効期限： ご利用の決済方法によって有効期限が異なります。

⚠️
KOMOJUの一部の決済方法は管理画面から有効期限を変更できますが、決済機関の仕様により期限が固定されているものもございます。

同期の不整合が発生するケース

設定変更が可能な決済方法において、KOMOJU側の有効期限をShopifyの制限である「72時間」よりも長く設定した場合、ステータス同期の不整合が発生する可能性があります。

例えば、お客様（購入者）がShopifyの72時間以内に決済を完了しなかったため、Shopify側で自動的に注文がキャンセルされたとします。その後、お客様がKOMOJU側の有効期限内に支払いを完了した場合、KOMOJUからShopifyへ「決済完了」の通知を送ろうとしても、Shopify側の注文がすでに閉じられているため、オーダーステータスが正しく更新されません。

推奨される設定

このような事象を防ぐため、変更可能な決済方法については、KOMOJU側の有効期限を「Shopifyの72時間（3日）以内」に設定することを推奨いたします。これにより、両システム間で決済情報が常に正しく同期されるようになります。

まとめ

✅

役割分担と紐づき： Shopifyが「注文」を、KOMOJUが「決済」を管理し、両システムが決済IDを通じて連携する仕組み

1対1の対応関係： 原則として、1つのShopify注文に対して1つのKOMOJU決済IDが対応していること

IDの確認・検索方法： Shopifyのタイムライン、およびKOMOJU管理画面の両方から決済情報やオーダーIDを確認する手順

ステータスの同期と表示： 「保留中」の決済はKOMOJU側のみに作成され、オーソリの完了後にShopify側のタイムラインへ反映される仕様