ビジネスシステム
トランザクションとフルフィルメント
ホスト型チェックアウト、注文、支払い、領収書、在庫、配送を単一のトランザクションコアで管理します。
注文は、顧客が何を購入し、いくら支払ったかを記録するものです。チェックアウトはKanorioがホストするチェックアウト画面で実行され、支払いと領収書の発行を処理した後、顧客をフロントエンドにリダイレクトします。
コアオブジェクト
- 注文(Orders): 明細項目、合計金額、顧客情報、支払いおよびフルフィルメントのステータス。
- トランザクション(Transactions): 注文に対する支払いと返金。
- フルフィルメント(Fulfillment): 物理的な商品の配送、およびデジタル商品へのアクセス権の付与。
APIの役割
- 購入ボタンを
return_toURLを使用してホスト型チェックアウトにリンクします。支払いが完了すると、リンクされた権限が自動的に付与されます。 - Management APIを使用して注文を読み取り、Customer APIを通じて顧客が自身の注文や領収書を確認できるようにします。
- Webhooksは、支払い済み注文、返金、配送ステータスの変更を報告し、追跡可能な
operationIdを提供します。
返金は管理画面から実行されます。トークンには返金権限が付与されることはありません。
API で利用できる範囲
- Orders & hosted checkout提供中
- API
- Management API
orders.*; CustomerGET /orders,GET /orders/:id - ホスト型サイト
/orders,/data/orders; system-hosted checkout &/account/orders- Webhooks
ec.order.paid
- Merchant-to-customer subscriptions (recurring billing)予定
- API
- Planned (
subscriptions.*), a sub-domain of the transaction core; not derived from the site's own Kanorio plan - ホスト型サイト
- Planned
API リファレンス
Webhook イベント
- ec.order.paid · Fired when an order payment succeeds and is captured.
- ec.shipment.statusChanged · Fired when a shipment status transitions (in transit, arrived at store, delivered, or exception).
- ec.order.refunded · Fired once per successful refund (partial or full, issued from the dashboard, at the payment provider, or by a lost chargeback) with the refunded lines and the order's refund status after it.
最近の変更
- 2026-11-03 Customer API: course, unit and order text in the customer's locale
- 2026-11-02 Products: shipping is decided per variant
サイト運営者向け
管理画面での使い方はヘルプセンターで説明しています。
ヘルプセンターを開く