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

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

## 使用场景
>  已支持：
	1.查询发放平台生成的订单（当前季度和上个季度）
	2.发放平台未找到，则直接查询微信订单
>  不支持:
	1.礼品id和appId必传，否则不去查询微信订单

## API描述
>  API描述：发放平台支付单据查询

## 请求流程

>   1. 在超8平台中申请第三方系统的应用Access Key和密钥（线下）。
>   2. 第三方系统根据应用Access Key和密钥向系统发起**Access Token**申请【[如何获取token](https://developers.yesno.com.cn/doc/57/ "如何获取token")】。
>   3. 三方系统调用防伪领域服务的开放接口进行数据对接。

> 具体请求请参阅：
>请参阅  [请求流程](https://developers.yesno.com.cn/doc/56/ "请求流程")

## 请求信息

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

### header头
请参阅 [通用请求头](https://developers.yesno.com.cn/doc/56/ "请求头")

## 请求参数

<tr><td>thirdId</td><td>string</td><td>必填</td><td></td><td>第三方业务单号id唯一</td><td></td></tr>

<tr><td>outDetailNo</td><td>string</td><td>必填</td><td></td><td>商户转账明细单号</td><td></td></tr>

<tr><td>giftNo</td><td>string</td><td>必填</td><td></td><td>礼品编号</td><td></td></tr>

<tr><td>appId</td><td>string</td><td>必填</td><td></td><td>appId,公众号/小程序id</td><td></td></tr>

</table>

## 返回消息体

| 名称      | 类型    | 是否必须 | 默认值 | 备注       | 其他信息          |
|-----------|---------|----------|--------|------------|-------------------|
| 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   | 错误原因|

## 请求示例
``` text
请求地址：{URL}/v1/pay/open/query-transfer-result-gift?thirdId=ddd4d&giftNo=d3dd&appId=d2ddd&outDetailNo=dds

```

## 响应示例

```json
{
    "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
}
```

## 异常示例
```json
{
  "code": 21224052,
  "message": "未找到订单",
  "traceId":"xxxxxx",
  "timestamp": 1679368912568
}
```

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