1. 外卖订单
Gokoo Third-Party Integration API
  • En
    • Start Readme Channel API Guide
    • Authentication
      • Channel Partner Authorization Login
      • Get Channel Partner AccessToken
      • Get Merchant OpenID
    • Product Management - Categories
      • Create Category
      • Edit Category
      • Delete Category
      • Get Category Detail
      • List Categories (Management)
      • List All Categories (For Product List)
      • Sort Categories
    • Merchant Management
      • Set delivery time
      • Business hours-set by day
      • Business hours setting
      • Modify business status
      • Set appointment days
      • Business hours management
    • Product Management - Products
      • Create Product
      • Edit Product
      • Delete Product
      • Get Product Detail
      • List Products
      • Search Products
      • Upload Product Image
      • Set Product On/Off Shelf (Batch)
      • Batch Update Product Stock
      • Batch Sold Out (Clear Stock)
      • Sort Products
    • Delivery Orders
      • Accept Order
      • Cancel Order (Merchant Reject)
      • Mark Food Ready (Prepared)
      • Apply for Delivery / Merchant Start Self-Delivery
      • Merchant Self-Delivery Completed
      • Query Order by Pickup Code
      • Verify Pickup Order (Scan Code)
      • List Orders (By Status)
      • Get Order Detail
      • Get Order Financial Details
      • Reprint Receipt
      • Order financial details-for Thailand
      • Order financial details-for Malaysia
    • Webhooks
      • Order Status Change Callback
  • 中文
    • 接口说明 v1.0
    • 商品管理
      • 商品排序
      • 全部分类(商品列表用)
      • 添加分类
      • 分类管理列表
      • 删除分类
      • 商品图片上传
      • 商品上下架(含批量)
      • 分类详情
      • 添加商品
      • 商品列表(搜索)
      • 商品批量改库存
      • 删除商品
      • 商品详情
      • 修改商品
      • 商品批量沽清
      • 分类排序
      • 商品列表
      • 修改分类
    • 商户管理
      • 营业时间——按天设置
      • 设置配送时间
      • 营业时间设置
      • 修改营业状态
      • 营业时间管理
      • 设置预约天数
    • 账户部分
      • 渠道商授权获取AccessToken
      • 渠道商授权获取商户openid
      • 渠道商授权登录
    • 外卖订单
      • 重新打印小票
        POST
      • 订单状态变更回调
        POST
      • 扫码核销订单
        POST
      • 取消订单(商家拒单)
        POST
      • 自提码查询订单
        POST
      • 订单账目
        POST
      • 订单列表(各种状态的)
        POST
      • 订单详情
        POST
      • 订单财务明细-泰国
        POST
      • 订单财务明细-马来西亚
        POST
      • 沙箱-创建订单
        POST
      • 接单
        POST
      • 出餐
        POST
      • 申请配送_商家自己开始配送
        POST
      • 商家自配送完成
        POST
      • 沙箱-发送订单状态变更回调
        POST
  • Schemas
    • CommonBodyParams
    • CommonResponse
    • SuccessResponse
    • ErrorResponse
    • TimeSlot
    • TimeSlotWithSeconds
    • CategoryItem
    • ProductItem
    • NormSpec
    • NormGroup
    • OrderProduct
    • ShowButtons
    • StaffInfo
  1. 外卖订单

订单状态变更回调

POST
{渠道回调URL}
订单状态变更后平台对渠道的通知
参数名必选类型说明
time是intunix时间戳
nonce_str是string随机字符串
sign是string校验字符串
data是object回调参数
data.openid是string商户openid
data.type是string回调类型,ORDER_STATUS_CHANGE:订单状态变更
data.data.order_id是string订单号
data.data.status是string订单状态:见下表
data.label是string订单状态描述
订单状态表:
状态说明
WAIT_MERCHANT_CONFIRM待接单
WAIT_DRIVER_CONFIRM等待骑手接单
MERCHANT_CONFIRMED商家已接单
DRIVER_CONFIRMED骑手已接单
DRIVER_ARRIVED骑手已到店
DRIVER_DELIVERING骑手开始配送
DRIVER_DELIVERED骑手配送完成
WAIT_COMMENT待评价
MERCHANT_DELIVERING商家开始配送
MERCHANT_DELIVERED商家已送达
ORDER_DONE已完成
ORDER_REFUNDED已退款
ORDER_CANCEL已取消
参数加密方式:
校验码生成规则:
$data_str = 将数组data按key正序排序后以 & 连接后得到的最符串,如果value是数组,则先进行json_encode操作;

Request

Path Params

Header Params

Body Params application/json

Example
{
    "time": "{timestamp}",
    "nonce_str": "{random_str}",
    "sign": "{sign_str}",
    "data": {
        "openid": "{openid}",
        "type": "ORDER_STATUS_CHANGE",
        "data": {
            "order_id": "{ORDER_ID}",
            "status": "{ORDER_STATUS}"
        },
        "label": "{ORDER_STATUS_LABEL}"
    }
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '' \
--header 'Authorization: {{bearerToken}}' \
--header 'Content-Type: application/json' \
--data '{
    "time": "{timestamp}",
    "nonce_str": "{random_str}",
    "sign": "{sign_str}",
    "data": {
        "openid": "{openid}",
        "type": "ORDER_STATUS_CHANGE",
        "data": {
            "order_id": "{ORDER_ID}",
            "status": "{ORDER_STATUS}"
        },
        "label": "{ORDER_STATUS_LABEL}"
    }
}'

Responses

🟢200
application/json
Success
Bodyapplication/json

Example
{
    "status": "1"
}
Modified at 2026-06-30 02:57:16
Previous
重新打印小票
Next
扫码核销订单
Built with