内购

鉴权方式

本章节内容使用的鉴权方式为 接口鉴权 ，请确认这是您想要的鉴权方式，详见选择鉴权方式。

一、后端对接

请完成后端内购支付的接入，在后端实现对应接口后，再执行下一步操作。

未实现后端接口就进行页面对接，可能会触发平台服务器的告警。

二、前端对接

导入 SDK

请先确保已经导入 SDK，再执行下一步操作。

SDK 方法名称

superPay

调用示例

XL_GAME.callApp(
  'superPay',
  {
    cpOrderId: '123456',
    gameId: '2222',
    productName: '元宝',
    price: 100,
    server_id: '123',
    role_id: '456',
    role_name: '我是测试角色名'
    key1: '我是自定义字段1', // cp自定义字段1（非必要，仅仅是举例）
    key2: 123 // cp自定义字段2（非必要，仅仅是举例）
    ...
  },
  (res) => console.log(res),
);

调用参数说明

参数	类型	必选	说明
cpOrderId	string	是	游戏方的订单号
gameId	string	是	平台的游戏 ID
productName	string	是	商品名称
price	number	是	商品价格，单位“分”（已弃用，实际通过后端接口获取价格，但仍建议写上）
server_id	string	是	区服 ID
role_id	string	是	角色 ID
role_name	string	是	角色名称
其它字段	string / number	否	其它自定义字段，回调游戏方接口时数据会写到 ext2 参数里面，参数不宜过多过长，数据不宜为嵌套的 JSON 格式（由于平台侧下单时会二次 encode，使用复杂的 JSON 数据可能会导致游戏方发货失败）

回调返回参数说明

支付回调的返回参数是一个对象，各参数语义说明如下：

参数	说明
errorCode	错误码。errorCode = 0 为支付成功，其它均为失败
errorMsg	错误信息
payment	支付方式，可选值：alipay weixin
orderId	订单 ID