对外发放平台微信发放

#  对外发放平台微信发放 `公开`

## 使用场景
>  已支持：
	1.通过微信进行支付
>  不支持:
	1.通过非微信进行支付

## 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                                                  |
|----------|-----------------------------------------------------------------------------------------------|
| 请求方法 | POST                                                   |
| 请求路径 | /marketing/v1/pay/open/wechat-transfer                |

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

## 请求参数

<tr><td>payRemark</td><td>string</td><td>必填</td><td></td><td>支付备注</td><td>长度应为1到500</td></tr>

<tr><td>giftNo</td><td>string</td><td>必填</td><td></td><td>礼品编号</td><td>长度应为1到30</td></tr>

<tr><td>thirdId</td><td>string</td><td>必填</td><td></td><td>第三方业务单号id唯一</td><td>长度应为1到128</td></tr>

<tr><td>openId</td><td>string</td><td>必填</td><td></td><td>openId</td><td>长度应为1到200</td></tr>

<tr><td>appId</td><td>string</td><td>必填</td><td></td><td>appId,公众号/小程序id</td><td>长度应为1到64</td></tr>

<tr><td>sign</td><td>string</td><td>必填</td><td></td><td>签名信息</td><td>秘钥管理获取秘钥，和请求参数生成sign传入接口</td></tr>

<tr><td>activityNo</td><td>string</td><td>必填</td><td></td><td>活动编号</td><td>长度不能大于64</td></tr>

<tr><td>amount</td><td>数值</td><td>必填</td><td></td><td>金额</td><td>转账金额单位为元，小数点后二位，金额全部以人民币为结算单位</td></tr>

<tr><td>unionId</td><td>string</td><td>非必填</td><td></td><td>unionId</td><td>长度应为1到200</td></tr>

<tr><td>businessId</td><td>string</td><td>非必填</td><td></td><td>中奖记录ID</td><td>长度不能大于128</td></tr>

<tr><td>businessNo</td><td>string</td><td>非必填</td><td></td><td>订单编号</td><td>长度不能大于64</td></tr>

<tr><td>businessRemark</td><td>string</td><td>非必填</td><td></td><td>业务备注</td><td>长度不能大于500</td></tr>

<tr><td>userNo</td><td>string</td><td>非必填</td><td></td><td>用户编号</td><td>长度不能大于100</td></tr>

<tr><td>userName</td><td>string</td><td>非必填</td><td></td><td>用户名称</td><td>长度不能大于100</td></tr>

<tr><td>userType</td><td>数值</td><td>非必填</td><td></td><td>用户类型</td><td>用户类型：0消费者，1店员，2店长，4经销商业务员，3经销商负责人，5大区业务员，6大区负责人，默认消费者</td></tr>

<tr><td>mobile</td><td>string</td><td>非必填</td><td></td><td>手机号</td><td>长度不能大于16</td></tr>

<tr><td>orgNo</td><td>string</td><td>非必填</td><td></td><td>组织编号</td><td>长度不能大于256</td></tr>

<tr><td>orgName</td><td>string</td><td>非必填</td><td></td><td>组织名称</td><td>长度不能大于256</td></tr>

<tr><td>code</td><td>string</td><td>非必填</td><td></td><td>数码</td><td>长度不能大于100</td></tr>

</table>

## 返回消息体

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

## 请求示例
``` text
请求地址：{URL}/v1/pay/open/wechat-transfer
Post参数：
{
    "giftNo":"zstyhb",
    "thirdId":"thirdId0031",
    "openId":"aaaaa",
    "unionId":"unionId001",
    "amount":"0.3",
    "appId":"aaaaaa",
    "businessId":"15",
    "businessNo":"",
    "businessRemark":"",
    "sign":"58e6205bddef159ca778a089e5b3153aac84d087d6f27aa541b0ed97c09c4320",
    "payRemark":"红包祝福语",
    "activityNo":"zstyhb",
    "userNo":"",
    "userName":"",
    "userType":"0",
    "mobile":"",
    "orgNo":"",
    "orgName":"",
    "code":""
}
```

## 响应示例

```json
{
    "code": 200,
    "message": "success",
    "data": "",
    "timestamp": 1679565957862,
    "traceId": "221198c7-ccf5-444e-a088-12aae8d995fd"
}
```

## 异常示例
```json
{
  "code": 135630001,
  "message": "参数错误",
  "traceId":"xxxxxx",
  "timestamp": 1679368912568
}
```

## 返回码
| 返回码 | 描述 |  解决方案|
| --- | --- | --- | 
21224022|业务单号id长度不能大于128|
21224023|数码长度不能大于100|
21224024|订单编号长度不能大于64|
21224025|业务备注长度不能大于500|
21224026|礼品编号不能为空|
21224027|礼品编号长度应为1到30|
21224028|openId长度应为1到200|
21224029|数量不能为空|
21224030|支付备注长度应为1到500|
21224031|活动名称长度不能大于100|
21224032|活动编号长度不能大于64|
21224033|用户编号长度不能大于100|
21224034|用户名称长度不能大于100|
21224035|手机号长度不能大于16|
21224036|组织名称长度不能大于256|
21224037|appId长度应为1到64|
21224038|礼品类型应为红包类型|
21224039|礼品状态应为可用状态|
21224040|用户类型应为0到6|
21224041|appId没有和商户号关联|
21224042|第三方业务单号id长度应为1到128|
21224043|第三方业务单号id不能为空|
21224044|openId不能为空|
21224045|支付备注不能为空|
21224046|appId不能为空|
21224047|数量应大于0并且只能小数点后二位|
21224048|礼品id不能为空|
21224049|增减类型不能为空且只能为1或者2|
21224050|分配数量应大于0并且只能小数点后二位|
21224051|库存不足|
21224052|未找到订单
21224053|unionId长度应为1到200
21224054|活动编号不能为空
21224055|活动信息不正确
21224056|活动与礼品未关联
21224057|组织编号长度不能大于256
21224058|查询微信订单失败
21224059|秘钥配置不正确
21223004|系统异常，请联系管理员!