getPrepay(data: GetPrepayParams)

版本要求:
@tuya-miniapp/cloud-api≥1.6.1

描述

发起订单预支付，获取支付页面信息（如收银台跳转链接）。

参数

参数类型必填说明
是请求参数

返回值

类型：Promise<GetPrepayResult>
预支付信息，包含订单号、支付地址与预支付单号

引用对象

interfaceGetPrepayResult预下单（发起支付）结果
属性类型描述
orderIdstring订单号
paymentUrlstring支付地址，用于跳转到支付页面
preFlowCodestring预支付单号
扩展信息
enumVasPaymentOS
枚举值实际值描述
VasPaymentOS.ANDROID1安卓
VasPaymentOS.IOS2iOS

合法值

VasPaymentOS
值说明最低版本
1安卓-
2iOS-

示例代码

请求示例

import { getPrepay, VasPaymentOS } from '@tuya-miniapp/cloud-api';

getPrepay({
  shopCode: 'your_shop_code',
  mallCode: 'your_mall_code',
  siteCode: 'your_site_code',
  orderId: 'your_order_id',
  os: VasPaymentOS.IOS,
  clientInfo: {},
  returnPage: '/payment-center/miniapp-result?appscheme=your_app_scheme',
  expireUrl: '/payment-center/miniapp-expire?appscheme=your_app_scheme',
  cancelPage: '/payment-center/miniapp-expire?appscheme=your_app_scheme',
  paymentProvider: 'your_paid_provider_name',
  paymentType: 'your_paid_type_name',
  commodityRelateContactInfos: [
    // 履约家庭级别传 code '3'（按需二选一）
    { code: '3', value: '{"groupId": "your_group_id", "groupName": "your_group_name"}' },
    // 履约设备级别传 code '4'（按需二选一）
    { code: '4', value: '{"devId": "your_dev_id", "deviceName": "your_device_name", "uuid": "your_device_uuid"}' },
  ],
})
  .then(prepay => {
    console.log('预支付信息:', prepay);
  })
  .catch(error => {
    console.error('发起预支付失败:', error);
  });

返回示例

{
  "orderId": "your_order_id",
  "paymentUrl": "https://example.com/payment/checkout",
  "preFlowCode": "PF20231018001"
}