接口 activity.voucher.receive.url.inapp
接口说明
获取一个兑换码领取 URL,第三方请求后需要控制客户端重定向到此 URL 领取成功,第三方的活动应该保留一份此 URL 方便用户查看历史记录,此接口业务适用于非微信和支付宝的 APP
业务流程
业务参数
| 参数名称 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| VoucherID | string | Y | 兑换券活动 ID,由运营商提供 |
| BarCode | string | Y | 商品条码 |
| OpenID | string | Y | 第三方的用户唯一标识 |
| ReturnUrl | string | N | 跳转 URL,用户领取后自动跳转此 URL |
| NickName | string | N | 第三方用户的昵称 |
| Sex | int | N | 第三方用户的性别 0=未知 1=男 2=女 |
| Province | string | N | 第三方用户所在省份 例如:广东省 |
| City | string | N | 第三方用户所在的城市 例如:深圳市 |
返回结果
| 参数名称 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| RedirectUrl | string | Y | 需要跳转的 URL |
返回示例
{
"error_code": 0,
"error_msg": "SUCCESS",
"data": {
"RedirectUrl": "http://c.yopoint.com/activity/voucher/appindex?EncryptCode=c0379048b0cf398f28d18cde24175f919a033878de910f063e633275d7306ff757b20da3a549ac9ec1ce9d30fde1fe8344ff67e0",
"EncryptCode":"xxxxx"
}
}
错误描述
| error_msg | 描述 |
|---|---|
| MISSING_PARAMS_VOUCHERID | 缺少参数:凭证 ID |
| MISSING_PARAMS_BARCODE | 缺少参数:商品条码 |
| MISSING_PARAMS_OPENID | 缺少参数:OPENID |
| ERR_ACTIVITY_VOUCHER_DISABLED | 错误:活动兑换券不可用 |
| 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 | 错误:兑换码已领完 |
说明
RedirectUrl 可以在 APP 中的 webview 打开