用户付费

utools.isPurchasedUser()

用户付费状态

类型定义

function isPurchasedUser(): boolean|string

示例代码

const purchase = utools.isPurchasedUser();
if (typeof purchase === "boolean") {
  // 付费买断
} else {
  // 按时长订阅
  // purchase 的格式为 yyyy-mm-dd hh:mm:ss
}

utools.openPurchase(options, callback)

打开付费页面

类型定义

function openPurchase(options: OpenPurchaseOptions,callback: PurchaseCallback): void

OpenPurchaseOptions 类型定义

interface OpenPurchaseOptions {
  goodsId: string;
  outOrderId?: string;
  attach?: string;
}

字段说明

• goodsId

  商品 ID，在 “ uTools 开发者工具” 插件应用中创建

• outOrderId

  第三方服务生成的订单号（6 - 64 字符）

• attach

  第三方服务附加数据，在查询 API 和支付通知中原样返回，可作为自定义参数使用（最多 256 字符）

PurchaseCallback 类型定义

PurchaseCallback(): void

示例代码

utools.openPurchase(
  {
    goodsId: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", // 商品 ID
  },
  () => {
    console.log("支付成功");
  }
);

utools.openPayment(options, callback)

打开付费页面

类型定义

function openPayment(options: OpenPaymentOptions,callback: PaymentCallback): void

OpenPaymentOptions 类型定义

interface OpenPurchaseOptions {
  goodsId: string;
  outOrderId?: string;
  attach?: string;
}

字段说明

• goodsId

  商品 ID，在 “ uTools 开发者工具” 插件应用中创建

• outOrderId

  第三方服务生成的订单号（6 - 64 字符）

• attach

  第三方服务附加数据，在查询 API 和支付通知中原样返回，可作为自定义参数使用（最多 256 字符）

PaymentCallback 类型定义

PurchaseCallback(): void

示例代码

utools.openPayment(
  {
    goodsId: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", // 商品 ID
  },
  () => {
    console.log("购买成功");
  }
);

utools.fetchUserPayments()

获取用户支付记录

类型定义

function fetchUserPayments(): Promise<Payment[]>

Payment 类型定义

interface Payment {
  order_id: string;
  out_order_id: string;
  open_id: string;
  pay_fee: number;
  body: string;
  attach: string;
  goods_id: string;
  paid_at: string;
  created_at: string;
}

字段说明

• order_id

  uTools 订单 ID

• out_order_id

  外部或第三方服务生成的订单号

• open_id

  uTools 用户 ID

• pay_fee

  支付金额，单位为分

• body

  商品描述

• attach

  附加数据

• goods_id

  商品 ID

• paid_at

  支付时间

• created_at

  订单生成时间

示例代码

utools.fetchUserPayments().then((payments) => {
  console.log(payments);
});