购买礼品卡
创建礼品卡购买单，用户支付成功后，会给用户发放对应数量的礼品卡。
接口说明
请求方式：
posthttps://p.wecard.tencent.com/cloudpay/v1/wallet/out/buy_cards
请求参数
Request
Body 包体
PayType必填
string
支付场景:
MINI_PROGRAM：小程序;
PUBLIC:公众号;
PC:网页支付;
H5：手机H5支付;
APP:手机app支付；
最小长度：1 最大长度：50
PayChannel必填
string
支付方式；如：
B2BBANK:企业网银支付;
ENTPAY:银行App支付;
B2BTRANSFER:转账支付;
BALANCEPAY:余额支付;
ALIPAY: 支付宝；
WXPAY:微信支付；
UNIONPAY：银联支付
最小长度：1 最大长度：30
OutRechargeId必填
string
外部订单号，即业务系统侧订单；
只能是数字、大小写字母、下划线；且在同一个主体下唯一。
最小长度：6 最大长度：60
OrderSubject必填
string
订单标题
最小长度：1 最大长度：200
ExpireTime选填
string
订单过期时间，格式：2023-03-05 11:54:20
最小长度：1 最大长度：19
RechargeNotifyUrl选填
string
充值成功后的回调地址
最小长度：1 最大长度：255
ExternalPaymentData选填
string
支付渠道扩展字段，第三方通道的扩展信息，根据具体对接的渠道情况传值；
如：微信、支付宝下单时需要将用户的openid或userid，及应用id传入,结构如下
最小长度：1 最大长度：1024
PayerInfo选填
object
用户信息，转账支付、余额支付必填
SceneInfo选填
object
设备信息
Attachment选填
string
附加信息，在查询API和支付通知中原样返回，可作为自定义参数使用，实际情况下只有支付完成状态才会返回该字段
最小长度：1 最大长度：128
Remark选填
string
付款备注
最小长度：1 最大长度：128
CardBatchId必填
string
礼品卡批次 ID
CardQuantity必填
integer
购买张数
{
"CardBatchId": 100,
"CardQuantity": 10,
"PayType": "MINI_PROGRAM",
"OrderSubject": "购买储值卡",
"OutRechargeId": "demo202211200001",
"RechargeNotifyUrl": "https://business.com/pay/notify",
"ExternalPaymentData": "{\"WxAppId\":\"wx43f1t4567721a03e\",\"WxOpenId\":\"oXLUp5OHJof5768CoFFDuuaRn8kc\"}",
"Currency": "CNY",
"Attachment": "原路返回string",
"SceneInfo": {
"DeviceType": "04",
"PayerClientIp": "14.15.16.17",
"DeviceId": "00000001",
"Longitude": "+121.48352",
"latitude": "+23.561345"
},
"Remark": "备注"
}
ExternalPaymentData 结构
| 变量 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| WxAppId | string | 否 | 微信开放平台审核通过的应用 AppId.(如：公众号 AppId/小程序 AppId) |
| WxOpenId | string | 否 | 微信用户在当前 WxAppId 下的 Openid，公众号及小程序场景下微信支付必填 |
| AliAppId | string | 否 | 支付宝开放平台审核通过的应用 AppId.(如：生活号 AppId/小程序 AppId) |
| AliUserId | string | 否 | 支付宝用户在当前 AppId 下的 Userid，公众号及小程序场景下支付宝支付必填 |
| AuthCode | string | 否 | 支付凭证：用户付款码。被扫场景下必填 |
返回参数
Response
200 OK
Response必填
object
{
"Response": {
"RequestId": "A8E7B797ADD44C3AA57E87AD7420A725",
"Result": {
"OutOrderId": "OUT2022111900000004",
"ChannelOrderId": "679735736991281152",
"ThirdPayOrderId": "230420127444480387",
"TotalAmount": "1000",
"RechargeStatus": "WAIT",
"PayInfo": "{\"appId\":\"wxad53ca7fbb5gg5f2\",\"timeStamp\":\"1681867396\",\"nonceStr\":\"94981e22ac0b4663949a442f31739b53\",\"package\":\"prepay_id=wx190923168532565900979a7da2170000000\",\"signType\":\"RSA\",\"paySign\":\"rhOR5lnhv6w2asdMiqRHU/aEZjhk1J4fGT2/Z5vxqtNcaLyHYmqDiIZZqxlSgSibWb/Z1a8SJdzLH9u0nnBKa0u0wtVaXgB6WKUahYtwQZC2ZadaYj6AkAeKLRIUHObVgAClbiiaiUjiaC9JUhj11m7JkClwpRvJkXQi4QzTdjA+kYv+32cgUido8SWIt6WZZXyH1qJTG1rYJC8IeUMgktH8oOoGzlxpaJbgB41j+pBd10b4R4DExlJ+KWP7N8iPj5YrbIzGJ2MsZ8L2U0jKLjpfKF/3d4hsc4or7EKIXdffgsreedaW6JzZ77gyb5ounChaea6CEP1UpUUAvgrkJwgw==\"}"
},
"ErrCode": "SUCCESS",
"ErrMessage": "成功"
}
}