商业系统
交易与履行
在单一交易核心上整合托管结账、订单、付款、收据、库存与运送。
订单记录了顾客的购买与付款内容。结账流程在 Kanorio 的托管结账页面上执行,该页面会处理付款与收据,随后将顾客重定向至您的前端。
核心对象
- 订单 (Orders): 包含项目明细、总金额、顾客信息以及付款与履行状态。
- 交易 (Transactions): 针对订单进行的付款与退款。
- 履行 (Fulfillment): 实体商品的运送与数字商品的访问授权。
API 如何运作
- 将您的购买按钮链接至托管结账页面,并设置
return_to网址。付款完成后,系统会自动授予链接的权益。 - 使用 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
给网站所有者
如何在后台使用这项产品,请参阅帮助中心。
打开帮助中心