属性名	类型	必填	差异化说明	最低支持基础库版本
goodType	number	是	本参数传2，同时 buyQuantity 字段不传	3.47.0
orderAmount	number	是	使用小额支付功能时，代表道具现金价格，单位为【分】，如价格为1钻，则回传10	3.47.0
goodName	string	否	道具名称，长度限制小于等于10个字符，用于区分道具类型，非必填	3.47.0

普通小游戏代码示例如下：

if (tt.canIUse('requestGamePayment.object.goodType')) {
   // 道具直购
   tt.requestGamePayment({
      goodType: 2,
      orderAmount: 10，
      goodName: "道具名称"
      currencyType: "CNY",
      zoneId: "1",
      customId: "QWERTYUIDFxxxxx", 
      mode: "game", // 支付类型
      env: 0, // 支付环境
      platform: "android",
      extraInfo: "extraInfo",  // extraInfo为字符串格式，用户自定义额外信息,支付结果回调信息包含此字段，基础库版本低于1.55.0没有此字段
      success(res) {
        console.log("调用函数成功");
      },
      fail(res) {
        console.log("调用函数失败");
      },
      complete(res) {
        console.log("调用完成");
      },
    });
} else {
    // 游戏币
    tt.requestGamePayment({
      mode: "game", // 支付类型
      env: 0, // 支付环境
      platform: "android", 
      currencyType: "CNY", // 币种：目前仅为 "CNY"
      buyQuantity: 600, // 购买数量，必须满足：金币数量*金币单价 = 限定价格等级（详见金币限定等级）
      zoneId: "1",
      customId: "QWERTYUIDFxxxxx", // 开发者自定义唯一订单号。如不填，支付结果回调将不包含此字段，将导致游戏开发者无法发放游戏道具, 基础库版本低于1.55.0没有此字段
      extraInfo: "extraInfo",  // extraInfo为字符串格式，用户自定义额外信息,支付结果回调信息包含此字段，基础库版本低于1.55.0没有此字段
      success(res) {
        console.log("调用函数成功");
      },
      fail(res) {
        console.log("调用函数失败");
      },
      complete(res) {
        console.log("调用完成");
      },
    });
}

Unity小游戏代码示例如下：

if (!CanIUse.RequestGamePayment)
{
    return;
}
if (CanIUse.RequestGamePaymentParams.GoodType) {
    var orderAmount = int.Parse(inputPrice.text);
    var orderInfoParams = new Dictionary<string, object>();
    orderInfoParams["mode"] = "game";
    orderInfoParams["env"] = "0";
    orderInfoParams["currencyType"] = "CNY"; // 固定值: CNY。币种
    orderInfoParams["platform"] = "android";
    orderInfoParams["customId"] = (TimeUtils.GetCurrentTimeMs() / 1000).ToString();
    orderInfoParams["goodType"] = 2;
    orderInfoParams["orderAmount"] = orderAmount;
    orderInfoParams["goodName"] = "测试商品";
    
    TT.RequestGamePayment(
        orderInfoParams,
        () =>
        {
            PrintText("Pay Success " + orderInfoParams["customId"]);
        },
        (errCode, errMsg) =>
        {
            PrintText("Pay failed - errCode: " + errCode + ", errMsg: " + errMsg, true);
        }
    );
} else {
    var quantity = int.Parse(inputPrice.text);
    Dictionary<string, object> orderInfoParams = new Dictionary<string, object>();
    orderInfoParams["mode"] = "game";
    orderInfoParams["env"] = "0";
    orderInfoParams["currencyType"] = "CNY"; // 固定值: CNY。币种
    orderInfoParams["platform"] = "android";
    orderInfoParams["buyQuantity"] = quantity;
    orderInfoParams["customId"] = (TimeUtils.GetCurrentTimeMs() / 1000).ToString();
    
    TT.RequestGamePayment(
        orderInfoParams,
        () =>
        {
            PrintText("Pay Success " + orderInfoParams["customId"]);
        },
        (errCode, errMsg) =>
        {
            PrintText("Pay failed - errCode: " + errCode + ", errMsg: " + errMsg, true);
        }
    );
}

获取支付结果，支付结果会发送给小游戏前端和小游戏服务端，开发者可通过以下方式对后续业务进行处理。

前端回调：小游戏可通过 tt.requestGamePayment / tt.openAwemeCustomerService 接口的 success 、fail、complete 参数设置不同支付结果的回调函数

小游戏服务端收到支付成功的服务端回调后，可通过 customId 或 extraInfo 判断是否为小额支付的回调。

总结

恭喜，你已经完成了小额支付接入教程。

你在该教程中了解了：

•

小额支付及其核心优势

•

如何接入小额支付

接下来，你可以将小额支付，应用于游戏内实际场景。

名称	类型	描述
tt.requestGamePayment	JSAPI	安卓发起支付JSAPI
tt.openAwemeCustomerService	JSAPI	iOS发起支付JSAPI

开发者文档

小额支付接入指引

简介

能力介绍

目标

相关接口

前提条件

学习内容

设计小额支付

接入小额支付

流程介绍

接入流程

总结