# トランザクションとフルフィルメント

> Hosted checkout, orders, payments, receipts, inventory and shipping on one transaction core.

> Markdown version of https://kanorio.com/ja/developers/products/orders. Append `.md` to any developer docs URL for this format. Index: https://kanorio.com/llms.txt · MCP: https://app.kanorio.com/api/mcp
>
> Translated from the English original: https://kanorio.com/en/developers/products/orders.md

Status: **Available**

注文は、顧客が何を購入し、いくら支払ったかを記録するものです。チェックアウトはKanorioがホストするチェックアウト画面で実行され、支払いと領収書の発行を処理した後、顧客をフロントエンドにリダイレクトします。

## コアオブジェクト

- **注文（Orders）:** 明細項目、合計金額、顧客情報、支払いおよびフルフィルメントのステータス。
- **トランザクション（Transactions）:** 注文に対する支払いと返金。
- **フルフィルメント（Fulfillment）:** 物理的な商品の配送、およびデジタル商品へのアクセス権の付与。

## APIの役割

- 購入ボタンを `return_to` URLを使用してホスト型チェックアウトにリンクします。支払いが完了すると、リンクされた権限が自動的に付与されます。
- Management APIを使用して注文を読み取り、Customer APIを通じて顧客が自身の注文や領収書を確認できるようにします。
- Webhooksは、支払い済み注文、返金、配送ステータスの変更を報告し、追跡可能な `operationId` を提供します。

返金は管理画面から実行されます。トークンには返金権限が付与されることはありません。

## What the APIs expose

| Capability | Status | API | Elements | Hosted site | Webhooks |
| --- | --- | --- | --- | --- | --- |
| Orders & hosted checkout | Available | Management API `orders.*`; Customer `GET /orders`, `GET /orders/:id` | — | `/orders`, `/data/orders`; system-hosted checkout & `/account/orders` | `ec.order.paid` |
| Merchant-to-customer subscriptions (recurring billing) | Planned | Planned (`subscriptions.*`), a sub-domain of the transaction core; not derived from the site's own Kanorio plan | — | Planned | — |

## API reference

- Management API: [Orders](https://kanorio.com/en/developers/management-api/orders) (2 operations)
- Management API: [Store](https://kanorio.com/en/developers/management-api/store) (1 operations)
- Customer API: [Orders](https://kanorio.com/en/developers/customer-api/orders) (2 operations)

## Webhook events

- `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.

Payloads: https://kanorio.com/en/developers/webhooks/events

## Recent changes

- 2026-11-03: Customer API: course, unit and order text in the customer's locale
- 2026-11-02: Products: shipping is decided per variant

Full changelog: https://kanorio.com/en/developers/changelog

## For site owners

Dashboard help: https://kanorio.com/ja/help/store-orders