1. Delivery Orders
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
        POST
      • Cancel Order (Merchant Reject)
        POST
      • Mark Food Ready (Prepared)
        POST
      • Apply for Delivery / Merchant Start Self-Delivery
        POST
      • Merchant Self-Delivery Completed
        POST
      • Query Order by Pickup Code
        POST
      • Verify Pickup Order (Scan Code)
        POST
      • List Orders (By Status)
        POST
      • Get Order Detail
        POST
      • Get Order Financial Details
        POST
      • Reprint Receipt
        POST
      • Order financial details-for Thailand
        POST
      • Order financial details-for Malaysia
        POST
    • Webhooks
      • Order Status Change Callback
  • 中文
    • 接口说明 v1.0
    • 商品管理
      • 商品排序
      • 全部分类(商品列表用)
      • 添加分类
      • 分类管理列表
      • 删除分类
      • 商品图片上传
      • 商品上下架(含批量)
      • 分类详情
      • 添加商品
      • 商品列表(搜索)
      • 商品批量改库存
      • 删除商品
      • 商品详情
      • 修改商品
      • 商品批量沽清
      • 分类排序
      • 商品列表
      • 修改分类
    • 商户管理
      • 营业时间——按天设置
      • 设置配送时间
      • 营业时间设置
      • 修改营业状态
      • 营业时间管理
      • 设置预约天数
    • 账户部分
      • 渠道商授权获取AccessToken
      • 渠道商授权获取商户openid
      • 渠道商授权登录
    • 外卖订单
      • 重新打印小票
      • 订单状态变更回调
      • 扫码核销订单
      • 取消订单(商家拒单)
      • 自提码查询订单
      • 订单账目
      • 订单列表(各种状态的)
      • 订单详情
      • 订单财务明细-泰国
      • 订单财务明细-马来西亚
      • 沙箱-创建订单
      • 接单
      • 出餐
      • 申请配送_商家自己开始配送
      • 商家自配送完成
      • 沙箱-发送订单状态变更回调
  • Schemas
    • CommonBodyParams
    • CommonResponse
    • SuccessResponse
    • ErrorResponse
    • TimeSlot
    • TimeSlotWithSeconds
    • CategoryItem
    • ProductItem
    • NormSpec
    • NormGroup
    • OrderProduct
    • ShowButtons
    • StaffInfo
  1. Delivery Orders

Order financial details-for Malaysia

Testing
POST
/api.php
The main structure of the order financial details is similar to the figure below, consisting of main projects and sub-projects. All entries contain a fields for extraction, storage and processing.
image.png

Order Statement Example:#

No.ItemSub-itemSub-item AmountAmount
ATotal order amountMYR123.49
Original product price + packaging fee120.5
User delivery fee (original price)2.99
BMerchant subsidyMYR0
CMerchant delivery fee subsidyMYR2.99
DPlatform subsidyMYR0
EPlatform delivery fee subsidyMYR0.00
FOrder SSTMYR0.00
= (Original product price + packaging fee - B) * 0.00% (merchant tax rate)
GActual customer paymentMYR120.5
= A - B - C - D - E + F
HPlatform expensesMYR0
Delivery fee deductionMYR0
IPlatform commissionMYR30.13
= (A - B - C - H) * 25.00% (merchant commission rate)
JActual platform service fee (excl. tax)MYR30.13
= I - D - E
KActual platform service fee (incl. platform SST)MYR32.54
= (I - D - E) * 108%Platform SST 8%2.41
LMerchant receivableMYR87.96
= G - H - K
MRider commissionMYR5.00
Amount not shown if rider not assigned / merchant self-delivery / pickup
NActual merchant receivableMYR84.97
= L - C
ODelivery feeMYR2.99
= Actual user delivery fee + C + EBase delivery feeMYR2.99

Order Statement:#

order_total_amountPlatformTotal order amount
A:order_total_amountPlatformTotal order amount
└ products_total_pricePlatformOriginal product price + packaging fee
└ hongbao_package_amountPlatformRed packet package purchase
└ user_delivery_feePlatformUser delivery fee (original price)
B:shop_subsidy_amountMerchantMerchant subsidy
└ first_shopMerchantMerchant first order discount
└ shop_manjian_youhuiMerchantMerchant spend-based discount
└ shop_coupon_youhuiMerchantMerchant coupon discount
└ shop_discount_youhuiMerchantMerchant discount
└ shop_vip_discount_youhuiMerchantMerchant VIP discount
└ shop_huangou_youhuiMerchantSwap purchase discount
└ shop_vip_youhuiMerchantMerchant VIP store-wide discount (to be deprecated)
C:shop_reduce_freightMerchantMerchant delivery fee subsidy
D:platform_subsidy_amountPlatformPlatform subsidy
└ first_roofPlatformFirst order discount
└ roof_manjian_youhuiPlatformSpend-based discount
└ roof_hongbao_amountPlatformRed packet deduction
E:platform_reduce_freightPlatformPlatform delivery fee subsidy
F:sst_amountPlatformOrder SST
G:user_pay_amountPlatformActual customer payment = A - B - C - D - E + F
H:platform_expensesPlatformPlatform expenses
└ platform_delivery_amountPlatformDelivery fee deduction
└ platform_hongbao_amountPlatformRed packet package deduction
I:platform_commission_ratioPlatformPlatform commission = (A - B - C - H) × merchant commission rate
J:platform_fee_amountPlatformActual platform service fee (excl. tax) = I - D - E
K:platform_fee_amount_with_sstPlatformActual platform service fee (incl. SST) = (I - D - E) × 108%
L:shop_revenue_amountMerchantMerchant receivable = G - H - K
M:staff_amountPlatformRider commission (amount not shown if rider not assigned / merchant self-delivery / pickup)
N:shop_real_revenue_amountPlatformActual merchant receivable = L - C
O:delivery_amountPlatformDelivery fee = actual user delivery fee + C + E
└ base_freightPlatformBase delivery fee
└ special_shop_subsidyPlatformSpecial merchant subsidy
└ time_subsidyPlatformTime-based subsidy
└ time_freight_discountPlatformTime-based delivery discount
└ capacity_controlPlatformCapacity management subsidy

Request

Query Params

Header Params

Body Params application/x-www-form-urlencoded

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 '/api.php?API=biz%2Fshop%2Ffinance%2Forder_balance' \
--header 'Authorization: {{bearerToken}}' \
--data-urlencode 'data={"order_id":"8000510"}' \
--data-urlencode 'CLIENT_API=BIZ' \
--data-urlencode 'openid={{openid}}'

Responses

🟢200
application/json
Success
Bodyapplication/json

Example
{
    "data": {
        "items": [
            {
                "index": "A",
                "title": "订单总金额",
                "amount": "946",
                "items": [
                    {
                        "title": "商品原价+包装费",
                        "amount": "938",
                        "fields": "products_total_price"
                    },
                    {
                        "title": "收用户配送费(原价)",
                        "amount": "8",
                        "fields": "user_delivery_fee"
                    }
                ],
                "gongshi": "",
                "fields": "order_total_amount"
            },
            {
                "index": "B",
                "title": "商家承担补贴",
                "amount": "0",
                "items": [],
                "gongshi": "",
                "fields": "shop_subsidy_amount"
            },
            {
                "index": "C",
                "title": "平台承担补贴",
                "amount": "0",
                "items": [],
                "gongshi": "",
                "fields": "platform_subsidy_amount"
            },
            {
                "index": "D",
                "title": "客人实际支付",
                "amount": "946",
                "items": [],
                "gongshi": "=A-B-C",
                "fields": "user_pay_amount"
            },
            {
                "index": "E",
                "title": "平台费用",
                "amount": "8",
                "items": [
                    {
                        "title": "配送费扣除",
                        "amount": "8",
                        "fields": "platform_delivery_amount"
                    }
                ],
                "gongshi": "",
                "fields": "platform_expenses"
            },
            {
                "index": "F",
                "title": "平台抽佣",
                "amount": "187.60",
                "items": [],
                "gongshi": "=(A-B-C-H)*20.00%(商家抽佣比例)",
                "fields": "platform_commission_ratio"
            },
            {
                "index": "G",
                "title": "商家应得",
                "amount": "750.4",
                "items": [],
                "gongshi": "=A-B-E-F",
                "fields": "shop_revenue_amount"
            },
            {
                "index": "H",
                "title": "骑手佣金",
                "amount": "143.00",
                "items": [],
                "gongshi": "骑手未接单\/商家自配送\/自提不显示金额",
                "fields": "staff_amount"
            },
            {
                "index": "I",
                "title": "平台实际服务费",
                "amount": "187.6",
                "items": [],
                "gongshi": "=F-C",
                "fields": "platform_fee_amount"
            },
            {
                "index": "J",
                "title": "商家实际应得",
                "amount": "750.4",
                "items": [],
                "gongshi": "=G-商家减免配送费",
                "fields": "shop_real_revenue_amount"
            },
            {
                "index": "K",
                "title": "配送费",
                "amount": "8",
                "items": [
                    {
                        "title": "基础配送费",
                        "amount": "8"
                    }
                ],
                "gongshi": "=实收用户配送费+商家减免配送费+配送卡",
                "fields": "delivery_amount"
            }
        ],
        "currency": "฿"
    },
    "error": "0",
    "message": "success"
}
Modified at 2026-06-09 09:45:45
Previous
Order financial details-for Thailand
Next
Order Status Change Callback
Built with