对外发放平台支付单据查询带gift


对外发放平台支付单据查询带gift 公开

使用场景

已支持:
1.查询发放平台生成的订单(当前季度和上个季度)
2.发放平台未找到,则直接查询微信订单
不支持:
1.礼品id和appId必传,否则不去查询微信订单

API描述

API描述:发放平台支付单据查询

请求流程

  1. 在超8平台中申请第三方系统的应用Access Key和密钥(线下)。
  2. 第三方系统根据应用Access Key和密钥向系统发起Access Token申请【如何获取token】。
  3. 三方系统调用防伪领域服务的开放接口进行数据对接。

具体请求请参阅:
请参阅 请求流程

请求信息

协议 HTTPS
请求方法 GET
请求路径 /marketing/v1/pay/open/query-transfer-result-gift

header头

请参阅 通用请求头

请求参数

名称类型是否必须默认值备注其他信息
thirdIdstring必填第三方业务单号id唯一
outDetailNostring必填商户转账明细单号
giftNostring必填礼品编号
appIdstring必填appId,公众号/小程序id

返回消息体

名称 类型 是否必须 默认值 备注 其他信息
code integer 非必须 错误码 format: int32
data object 非必须 返回值
message string 非必须 消息内容
timestamp integer 非必须 时间戳 format: int64
traceId string 非必须 链路追踪ID

data返回对象说明

参数名称 参数类型 参数说明
thirdId String 第三方业务单号id唯一
ccnBatchId String 发放平台业务流水号(平台交易唯一标识)
otherBatchId String 付款单号/批次单号
payStatus int 支付状态:0待支付,6支付中,7支付成功,8支付失败,99微信支付失败
payRemark String 支付备注
payResultDate String 订单支付成功时间
errorMsg String 错误原因

请求示例

请求地址:{URL}/v1/pay/open/query-transfer-result-gift?thirdId=ddd4d&giftNo=d3dd&appId=d2ddd&outDetailNo=dds

响应示例

{
    "code": 200,
    "message": "success",
    "data": {
        "otherBatchId": "10100835068142411297089383952931",
        "ccnBatchId": "20241128110101862076807019556864",
        "thirdId": "thirdId0029",
        "payStatus": 7,
        "payRemark": "红包祝福语",
        "payResultDate": "2024-11-29 13:50:38",
        "errorMsg": ""
    },
    "timestamp": 1733290527793,
    "traceId": "",
    "exception": null,
    "meta": null,
    "ext": null
}

异常示例

{
  "code": 21224052,
  "message": "未找到订单",
  "traceId":"xxxxxx",
  "timestamp": 1679368912568
}

返回码

返回码 描述 解决方案
21224052 未找到订单
21224003 企业号信息不一致
21220211 未获取到礼品数据
21224058 查询微信订单失败
21223004 系统异常,请联系管理员!

guanhengbing 2024年12月18日 17:40 73 收藏文档