接口 activity.voucher.receive.url
接口说明
获取一个兑换码领取 URL,第三方请求后需要控制### 客户端重定向到此 URL 才算领取成功### ,第三方的活动应该保留一份此 URL 方便用户查看历史记录,此接口业务适用于微信和支付宝内
业务参数
| 参数名称 |
类型 |
是否必须 |
说明 |
| VoucherID |
string |
Y |
兑换券活动 ID,由运营商提供 |
| BarCode |
string |
Y |
商品条码 |
| ReturnUrl |
string |
N |
跳转 URL,用户领取后自动跳转此 URL |
返回结果
| 参数名称 |
类型 |
是否必须 |
说明 |
| RedirectUrl |
string |
Y |
需要跳转的 URL |
| VoucherCode |
string |
Y |
明文兑换码 |
返回示例
{
"error_code": 0,
"error_msg": "SUCCESS",
"data": {
"RedirectUrl": "https://c.yopoint.com/activity/voucher/index?VoucherCode=8423383063813",
"VoucherCode":"8423383063813"
}
}
错误描述
| error_msg |
描述 |
| MISSING_PARAMS_VOUCHERID |
缺少参数:兑换码活动 id |
| MISSING_PARAMS_BARCODE |
缺少参数:兑换码活动 id |
| ERR_ACTIVITY_VOUCHER_DISABLED |
缺少参数:兑换码活动 id |
| ERR_INVALID_VOUCHER_ID |
错误:兑换码活动 id 不存在 |
| ERR_VOUCHER_NOT_FOUND |
错误:兑换码活动不存在 |
| ERR_INVALID_OID |
错误: 错误的运营商 ID |
| ERR_VOUCHER_HAS_OVERED |
错误:兑换码已结束 |
| ERR_INVALID_BARCODE |
错误:无效的商品条码 |
| ERR_INVALID_SKUS_BARCODE |
错误:无效的 SKU 条码 |
| ERR_VOUCHER_OVER_TOTAL |
错误:兑换码已领完 |