支付结果

事件分组事件标识
appsubscriptionappsubscription/paid
当商家的支付操作成功、取消或失败时，平台会向应用发送支付结果通知。
请求头
  • X-Shopline-Topic string required
    事件的唯一标识。
    例子: orders/edited
  • X-Shopline-Hmac-Sha256 string required
    该请求的签名。收到请求后，你需要对该签名进行 验签 以验证数据的真实性和完整性。
    例子: XWmrwMey6OsLMeiZKwP4FppHH3cmAiiJJAweH5Jo4bM=
  • X-Shopline-Shop-Domain string required
    店铺的域名。
    例子: example.myshopline.com
  • X-Shopline-Shop-Id string required
    店铺 ID。
    例子: 1610418123456
  • X-Shopline-Merchant-Id string required
    商家 ID。
    例子: 2000001234
  • X-Shopline-API-Version string required
    API 版本号。
    例子: v20250601
  • X-Shopline-Webhook-Id string required
    该 Webhook 事件的 ID。
    例子: b54557e48a5fbf7d70bcd043
请求体
  • appkey string
    应用的全局唯一标识符。
    例子: 56978e0b3f33365396d7786a62ed0a03727e3212
  • bizOrderNo string
    支付订单的业务订单号。创建支付链接时由应用主动传入，可用于应用关联其内部的业务单号。
    例子: PAY20240726123456
  • handle string
    店铺在 SHOPLINE 系统中的唯一标识符。
    例子: shopline
  • secondChannelId string
    二级渠道标识符，用于标识线下 POS 门店等特定销售渠道。
    适用场景：
    • 当套餐以单个门店为单位销售时，该字段标识具体门店。
    • 当套餐以整个店铺为单位销售时，该字段为空。
    例子: 4567223323
  • status integer
    支付最终状态标识。有效枚举值包含：
    • 200：支付成功。
    • 300：支付取消，指用户在页面主动放弃支付。
    • 400：支付失败，指用户同意支付后，系统扣费失败，可能是支付账号错误、余额不足等系统原因。
  • subId string
    关联的订阅订单号。
    例子: 6578332207010012345
  • subTime long
    支付操作的完成时间，格式为 13 位毫秒级时间戳。
    例子: 1722000000000
状态码
收到 SHOPLINE 发送的 Webhook 通知后，你需要按照如下 SHOPLINE 要求的格式进行响应。
HTTP/1.1 200 OK
关于如何订阅 Webhooks 及更多 Webhook 响应规则说明，请参考 Webhook 概述。
这篇文章对你有帮助吗？
SHOPLINE
SHOPLINE
SHOPLINE Enterprise
条款协议
隐私
条款
开发者协议
LinkedInEmail
LinkedInEmail
© Copyright 2013-2025 SHOPLINE Limited.