虚拟商品对接指南
适用场景说明：
虚拟商品是无实物性质，无需物流。买家下单时无需填写收货地址，无需物流下单付款成功即发货。适合场景：网上课程、话费充值，自动贩售机等。
需求说明：
买家: 购买虚拟商品 (比如：话费充值，视频会员充值等) 并选择。
商家: 需要自动化方式处理虚拟商品订单，为订单中的商品提供相关充值，出货服务。
场景流程图：
1. 话费，视频会员充值
Tips: 图中第三方是指：您需要调用的其他平台，比如您要再微商城中支持充值爱奇艺会员，就需要寻找爱奇艺的开放平台去对接爱奇艺的充值接口，比如充值话费也是一样的逻辑。有赞这边没有代充值功能，第三方的对接渠道需要开发者自己寻找。
2. 自动贩售机
商家对接流程：
第一步：注册认证
注册认证有赞云账号： https://doc.youzanyun.com/doc#/content/27027/27062
第二步：创建应用
商家选择 -> 创建自用型无容器应用并换取授权 token：https://doc.youzanyun.com/doc#/content/35701/36458
服务商选择 -> 创建工具型无容器应用并换取授权：https://doc.youzanyun.com/doc#/content/35701/36457
第三步：API 权限申请
请先申请相关接口的权限：https://developers.youzanyun.com/article/1556850673218
第四步：API 对接
商品对接
微商城店铺后台
微商城后台创建虚拟商品请查看该流程：https://help.youzan.com/displaylist/detail_4_1080
API 创建
| API 名称 | API 描述 | API 地址 |
|---|---|---|
| youzan.item.create | 新增商品 | 查看文档 |
| youzan.item.get | 获取单个商品信息 | 查看文档 |
| youzan.item.update | 更新商品 | 查看文档 |
| youzan.items.onsale.get | 获取出售中的商品列表 | 查看文档 |
更多商品 API 请访问：前往查看
订单对接（交易产生的订单）
1. 有赞订单同步到商家系统方案:https://developers.youzanyun.com/article/1556780673180
2. 虚拟商品商品订单状态流转：https://developers.youzanyun.com/article/1568018840745
Tips：虚拟商品订单同步和虚拟商品交易状态流转请结合在一起详细阅读。
核销虚拟订单（用于完成订单店铺回款）
| API 名称 | API 描述 | API 地址 |
|---|---|---|
| youzan.trade.virtualcode.apply | 核销虚拟订单 | 查看文档 |
| youzan.trade.virtualcode.get | 查询核销码详情 | 查看文档 |
退款 API（用于订单退款和退款查询）
| API 名称 | API 描述 | API 地址 |
|---|---|---|
| youzan.trade.refund.seller.active | 商家主动退款 | 查看文档 |
| youzan.trade.refund.get | 查看退款详情 | 查看文档 |
最后
1. 虚拟商品订单的处理流程是买家下单成功 -> 商家接收到订单 -> 调用第三方充值接口 -> 充值成功 -> 调用有赞的虚拟订单核销接口 - 订单完成
1. 虚拟商品订单的处理流程是买家下单成功 -> 商家接收到订单 -> 调用第三方充值接口 -> 充值失败 -> 调用有赞的退款接口主动退款 - 订单关闭。