跳到主要内容

内购

鉴权方式

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

一、后端对接​

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

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

二、前端对接​

导入 SDK

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

SDK 方法名称​

superPay

调用示例​

XL_GAME.callApp(
  "superPay",
  {
    cpOrderId: "123456",
    gameId: "2222",
    productName: "元宝",
    price: 100,
    server_id: "123",
    role_id: "456",
    // 由于 role_name（角色名称）需要作为 URL 参数传输，而游戏的角色名称可能存在特殊字符（这与游戏对角色名称的规范有关），
    // 故需对该参数值进行 URL 编码，在 JavaScript 中就是调用 encodeURIComponent
    // 在本示例，编码后的值为 %E6%88%91%E6%98%AF%E8%A7%92%E8%89%B2%E5%90%8D%E7%A7%B0
    role_name: encodeURIComponent("我是角色名称"),
    // 下面是游戏方传入的自定义字段，会透传到后端回调
    // 仅供示意，这些字段不是必需的
    cp_custom_key1:
      "我是游戏方提供的自定义字段，会透传到后端回调，这个字段不是必需的",
    cp_custom_key2: 123456789,
    ...
  },
  (res) => console.log(res),
);

调用参数说明​

参数类型必选说明
cpOrderIdstring是游戏方的订单号
gameIdstring是平台的游戏 ID
productNamestring是商品名称
pricenumber是商品价格，单位“分”（由于使用了“接口鉴权”，此字段值实际意义不大，实际通过后端接口获取价格，但仍建议写上）
server_idstring是区服 ID，即使游戏方没有和平台同步区服数据，也建议传入游戏的区服 ID，以完善平台的订单信息
role_idstring是角色 ID
role_namestring是角色名称，由于角色名称可能存在特殊字符，此值需经过 UTF-8 编码转义，比如 JavaScript 语言的 encodeURIComponent，C# 语言的 WebUtility.UrlEncode
其它字段string / number否其它自定义字段，回调游戏方接口时数据会写到 ext2 参数里面，参数不宜过多过长，数据不宜为嵌套的 JSON 格式（由于平台侧下单时会二次 encode，使用复杂的 JSON 数据可能会导致游戏方发货失败）
特别提醒

  1. server_id 参数应为字符串类型，不是数字类型。
    使用错误的数据类型可能触发后端的错误提示 invalid value for string field serverId。

  2. server_id role_id role_name 参数在后端回调接口 ext2 字段 的对应命名为 serverId roleId roleName。

回调返回参数说明​

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

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