Kanorio

商业系统

交易与履行

在单一交易核心上整合托管结账、订单、付款、收据、库存与运送。

可用

订单记录了顾客的购买与付款内容。结账流程在 Kanorio 的托管结账页面上执行,该页面会处理付款与收据,随后将顾客重定向至您的前端。

核心对象

  • 订单 (Orders): 包含项目明细、总金额、顾客信息以及付款与履行状态。
  • 交易 (Transactions): 针对订单进行的付款与退款。
  • 履行 (Fulfillment): 实体商品的运送与数字商品的访问授权。

API 如何运作

  • 将您的购买按钮链接至托管结账页面,并设置 return_to 网址。付款完成后,系统会自动授予链接的权益。
  • 使用 Management API 读取订单,并透过 Customer API 让顾客查看自己的订单与收据。
  • Webhooks 会回报已付款的订单、退款与运送状态变更,并提供可供追踪的 operationId。

退款需从后台执行。令牌绝不会被授予退款权限。

API 开放的范围

  • Orders & hosted checkout可用
    API
    Management API orders.*; Customer GET /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
查看完整更新日志

给网站所有者

如何在后台使用这项产品,请参阅帮助中心。

打开帮助中心