发红包
请求方式 | body | 编码 | 接口地址 |
---|---|---|---|
POST | application/json | UTF-8 | 集测:https://wpawtest.shengpay.com/api/v1/payment/unifiedorder/redEnvelopes 生产:https://wpaw.shengpay.com/api/v1/payment/unifiedorder/redEnvelopes |
请求参数
变量名 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
appId | String(32) | Y | djgeiq978y933 | 应用标识 |
appName | String(32) | Y | **商城 | 商户应用名称 |
mchId | String(16) | Y | 93751497 | 商户号 |
subMchId | String(16) | N | 子商户号 | |
outTradeNo | String(32) | Y | 1602835300345 | 商户订单号 |
timeStart | String(14) | N | 20180801160000 | 交易起始时间 |
timeExpire | String(14) | N | 20180801180000 | 交易结束时间 |
totalFee | int | Y | 1000 | 订单总金额(单位:分) |
body | String(128) | Y | 红包 | 商品描述 |
tradeType | String(20) | Y | RED_ENVELOPE_CLOUD | 交易方式 |
notifyUrl | String(300) | Y | https://notify.shengpay.com/notify | 商户通知回调地址 |
attach | String(1024) | N | {"payeeUnionId":"5ED6E39723074300B935","payerNickName":"小明","payerUnionId":"4DD6E39723075C024D760B95A","redType":2,"receiverType":"2","groupID":"123","groupName":"超自然研究实验室","groupAmount":"256"} | 附加信息(JSON字符串) |
AppId | String(32) | N | 4dad234 | 应用标识 |
AppName | String(32) | N | xxx应用 | 应用名称 |
imei | String(32) | N | 866146680853634 | 设备识别码 |
Payerip | String(32) | N | 107.122.198.219 | 付款方IP |
lati | String(32) | N | 47.999656 | 纬度 |
longi | String(32) | N | 134.027872 | 经度 |
mobilePhone | String(32) | N | 18012344616 | 发红包用户手机号码 |
osType | String(32) | N | Android | 手机操作系统 |
osVersion | String(32) | N | 9 | 操作系统版本 |
payerNickName | String(32) | N | 张三 | 发红包用户昵称 |
payerUnionId | String(32) | N | 4DD6E39723075C024D760B95A | 发红包用户标识 |
redType | String(32) | Y | 2 | 红包类型(普通红包:1,手气红包:2) |
receiverType | String(32) | Y | 2 | 接收者类型(个人:1,群红包:2,热聊:3) |
groupID | String(32) | Y | 群ID | |
groupName | String(32) | Y | 群名称 | |
groupAmount | String(32) | Y | 群成员数量 | |
nonceStr | String(32) | Y | pWUVWVYWNQhnTXpQzhIzMGCwqBkZclzg | 随机字符串 |
signType | String(8) | Y | RSA | 签名类型 |
sign | String (1024) | Y | 签名 |
请求示例
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
|
响应参数
变量名 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
returnCode | String | Y | SUCCESS | 返回码(SUCCESS/FAIL) |
returnMsg | String | N | 返回消息(当returnCode为FAIL时使用) | |
resultCode | String | Y | SUCCESS | 业务结果(SUCCESS/FAIL) |
errorCode | String | N | 错误代码(当resultCode为FAIL时使用) | |
errorCodeDes | String | N | 错误描述(当resultCode为FAIL时使用) | |
mchId | String(16) | Y | 商户号 | |
appId | String(32) | Y | djgeiq978y933 | 应用标识 |
prepayId | String(32) | Y | 预支付交易会话标识 | |
nonceStr | String(32) | Y | 随机字符串 | |
signType | String(8) | Y | RSA | 签名方式 |
sign | String (1024) | Y | 签名 |
响应示例
1 2 3 4 5 6 7 8 9 10 11 12 |
|