# 兑换虚拟号
# 接口说明
可通过该接口兑换虚拟号
# 注意事项
- 重新兑换的虚拟号码有效期为3天，每个订单可以兑换3次。
- 该接口用于在订单结束后，原虚拟号码会失效，商家可按需重新兑换虚拟号码。
# 接口调用请求说明
POST https://api.weixin.qq.com/channels/ec/order/virtualtelnumber/get?access_token=ACCESS_TOKEN
# 请求参数说明
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| order_id | string | 是 | 订单id，可通过获取订单列表接口获取 |
# 请求参数示例
{
"order_id": "12345"
}
# 返回参数说明
| 参数 | 类型 | 描述 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | string | 错误信息 |
| virtual_tel_number | string | 虚拟号码 |
| virtual_tel_expire_time | number | 虚拟号码过期时间 |
| get_virtual_tel_cnt | number | 兑换虚拟号码次数 |
# 返回参数示例
{
"errcode": 0,
"errmsg": "ok",
"virtual_tel_number": "6767532382",
"virtual_tel_expire_time": xxxxxxxx,
"get_virtual_tel_cnt": 1
}
# 错误码
| 错误码 | 错误描述 |
|---|---|
| 公共错误码 | - |
| 48001 | 无权调用本api，请检查相关权限是否已开通 |
| 47001 | 请求体格式不正确，请检查请求体中各个参数的类型是否正确 |
| 40097 | 请求体参数不正确，请检查各个参数是否按规范填写，具体原因请查看errmsg |
| 100002 | 订单不存在 |
| 100003 | 订单更新过于频繁，更新订单失败，请重试 |
| 6060453 | 不是虚拟号订单，不允许兑换虚拟号码 |
| 6060454 | 虚拟号码未过期，请获取订单详情查看 |
| 6060455 | 超过最大可兑换虚拟号码次数 |