收藏
评论

微信小游戏iOS虚拟支付接入指南官方

背景:

基于苹果公司推出的"小程序合作伙伴计划"(Mini Apps Partner Program),平台为开发者提供具体接入服务,共同建设一个健康繁荣的生态,为尽可能减少开发者的工作量,平台已兼容现有的虚拟支付实现接口,仅针对部分接口进行字段调整 樱花视频,具体接入指引如下。

 

一、  前置准备

1.  功能开通

游戏需先开通虚拟支付并在「MP-虚拟支付-iOS资金概况」完成签约:

 

2.  用户设备环境要求:

(1)操作系统要求:使用iPhone或者iPad,iOS 15及以上版本 樱花视频高清.

(2)基础库版本要求:3.10.3 及以上

(3)客户端版本要求: 8.0.68 及以上

(4)苹果支付不支持使用沙箱环境 樱花视频免费观看,仅支持使用现网环境.

如果无法支付 樱花视频网站,支付接口会返回 701001 ios not support.

 

3.  检查当前环境是否支持支付

开发者可使用以下接口wx,checkIsSupportMidasPayment,检查当前环境是否允许支付,若该api都不存在,则iOS一定不支持虚拟支付,请保持旧版本逻辑。 樱花视频

wx.checkIsSupportMidasPayment(Object object)

if (wx.checkIsSupportMidasPayment) {
    wx.checkIsSupportMidasPayment({
        success(res) {
          console.log('支持检查结果:', res)
          if (res.data.allow_pay) {
            console.log('当前环境支持支付')
            // 可以继续调用支付相关接口
          } else {
            console.log('当前环境不支持支付')
            // 请自行适配用户提示文案
          }
        },
        fail(err) {
          console.error('检查支持情况失败:', err)
        },
        complete() {
          console.log('检查完成')
        }
      })
}


success 回调函数参数

 

二、  接口协议

1.   游戏币 🔗虚拟支付2 樱花视频在线. 0游戏币 | 微信开放文档.

1.1 前端支付新API

🔗wx.requestMidasPaymentGameItem(Object object)

注意:该API和道具直购统一,通过mode字段区分,功能和原wx,requestMidasPayment等价,但更安全,推荐使用。 樱花视频高清

(1)platform字段废弃(可以不填 或 保持原样),用户支付方式平台会自动判断 樱花视频免费观看.

(2)游戏币模式下mode字段需要填“coins”

a.  product_id不用填写

b,  goodsPrice为游戏币单价,例如 1 人民币 = 10 游戏币,goodsPrice填写10 樱花视频.

c.  不支持attach

d.  其余字段保持不变

signData例子:

'{"mode":"coins","offerId":"123","buyQuantity":1,"env":0,"currencyType":"CNY","zoneId":"1","goodsPrice":10,"outTradeNo":"xxxxxx"}'

 

1.2 前端支付旧API

🔗wx 樱花视频在线. requestMidasPayment(Object object) | 微信开放文档.

注意:该接口因为不支持签名,存在被前端(外挂等工具)篡改的风险,不推荐开发者继续使用,推荐切换到wx.requestMidasPaymentGameItem(mode coins) 新API。

 

该接口开发者可以不做任何修改

(1)platform字段废弃(可以不填 或 保持原样),用户支付方式平台会自动判断

(2)因该接口下单的时候不支持签名,平台在🔗wx.requestMidasPaymentGameItem(Object object)上支持了游戏币模式(详细可见下文),

 

1.3 游戏币发货完成事件(Event=minigame_coin_deliver_completed)

🔗小游戏支付类订阅事件

增加 PayChannel 字段

具体含义: 0 微信支付 1 充值中心 2 ios支付

(1)  不再返回WeChatPayInfo

 

2.  道具直购 🔗虚拟支付2.0道具直购 | 微信开放文档

2.1 前端支付API

🔗wx.requestMidasPaymentGameItem(Object object)

该接口开发者可以不做任何修改

(1)platform字段废弃(可以不填 或 保持原样),用户支付方式平台会自动判断

(2)道具直购模式下mode固定填goods,与游戏币模式进行区分

 

2.2 道具发货消息协议

(1)  增加 PayChannel 字段

具体含义: 0 微信支付; 1 充值中心; 2 ios支付

(2)  不再返回WeChatPayInfo

详见:🔗道具发货消息协议

 

三、  订单查询

1.  实时接口查询

订单查询:🔗pay_v2.queryOrder | 微信开放文档

(1)  增加 pay_channel 字段

具体含义: 0 微信支付; 1 充值中心; 2 ios支付

(2)  不再返回mch_order_no和transaction_id

 

2.  MP-基础数据-统计-游戏日志分析-iOS 订单 查询

 

四、用户退款

iOS订单退款申请流程:「设置-账户-购买记录-订单详细信息-报告问题-请求退款」

用户申请后,开发者需对齐现有退款流程在MP操作订单退款


注意事项:

1.  iOS支付不支持苹果沙箱环境,所有支付流程需要在现网测试(即所有支付接口只允许env参数传入0),后续会增加对沙箱支付环境的支持。

2.  暂不支持Mac支付和非微信场景iOS支付。

3.  未成年用户退款流程,与现有未成年用户退款流程,前置增加用户向苹果申请退款的流程,后续流程保持一致。


最后一次编辑于  01-26
收藏