# 海外支付

# 游戏币

游戏币定义可见技术手册-虚拟支付篇
海外充值与国内有所不同,极端情况下充值成功后游戏币到账的延迟可能会较大,甚至需要用户重新拉起支付才能到账,所以建议开发者参考3.1.1.游戏币场景使用游戏币能力,把游戏币作为游戏内一种“点券”的概念,余额不足时,再拉起充值。
若存在充值成功但是游戏币未到账的情况,可以引导用户回到游戏内重新拉起支付。

# wx.requestMidasPayment 充值接口

wx.requestMidasPayment(Object object) 对于海外充值,我们精简了部分参数,只需要以下参数:

wx.requestMidasPayment({
 env:1, //  0 现网 1 沙箱 暂时只支持沙箱测试
 zoneId:"1" // 暂时只配置了分区 1,不同分区的游戏币余额独立,需要新增请联系平台添加
 buyQuantity:99 // 游戏币档位,详情见以下表格
 outTradeNo:"" //业务订单号,每个订单号只能使用一次,重复使用会失败。开发者需要确保该订单号在对应游戏下的唯一性,平台会尽可能校验该唯一性约束,但极端情况下可能会跳过对该约束的校验。要求32个字符内,只能是数字、大小写字母、符号_-|*组成,不能以下划线()开头。每次调用wx.requestMidasPayment都换新的outTradeNo。若没有传入,则平台会自动填充一个,并以下划线开头
 success(res, errCode) {
     console.log('pay', res, errCode);
 },
 fail({
     errMsg,
     errCode
 }) {
     console.error(errMsg, errCode)
 }

# 游戏币档位

与国内计算方法一致,需满足 buyQuantity * 游戏币单价 = 限定的价格等级 海外有效价格等级如下

美元(实际支付金额) 单位货币个数(buyQuantity)
0.99 99
1.99 199
2.99 299
4.99 499
9.99 999
19.99 1999
29.99 2999
49.99 4999
99.99 9999

当前游戏币单价为 0.01 美元

# 服务端接口

提供以下三条接口,服务端接口与国内对齐,需要把域名 api.weixin.qq.com 替换为 univapi.wechat.com

pay_v2.getBalance|微信开放文档

pay_v2.pay|微信开放文档

pay_v2.present|微信开放文档