新增商品价格查询 API，前端也能拿到实时价格

很多商户都遇到过同一个问题：商品在软代后台调了价或开了促销，官网页面上的价格却还是写死的旧数字，需要手动改一遍。为了解决这个痛点，我们为软代 JS 新增了商品价格查询 API，让您的页面价格与后台自动保持一致。

新的初始化方式

配合本次更新，软代 JS 的接入方式也做了调整：现在推荐先引入脚本，再调用 window.APSDAI() 初始化，写法更直观，同时能拿到实例调用 JS API。

<script src="https://i-cdn.softscdn.com/apsdai.min.js"></script>
<script>
const example = window.APSDAI({ name: 'your_merchant_code' });
</script>

需要特别注意：使用实例化方式时，禁止再通过 window.Apsdai 传入配置参数，配置只能在实例化参数中传递。原来的声明式写法（在引入脚本之前声明 window.Apsdai）依然可用，已接入的站点无需改动，但两种写法请二选一，不要混用。

查询商品价格

通过实例的 Product.Prices() 方法即可获取商品信息，第一个参数为后台商品的 PATH 值，第二个参数为可选的货币。

// 示例 1：使用自动货币选择
example.Product.Prices('PATH1')
    .then(res => { console.log(res); })
    .catch(err => { console.log(err); });

// 示例 2：指定货币
example.Product.Prices('PATH1', 'usd');

// 示例 3：一次查询多个商品
example.Product.Prices(['PATH1', 'PATH2', 'PATH3'], 'cny');

货币方面，国际站支持 cny、usd、twd、hkd，国内站仅支持 cny；不传则由系统自动选择。

返回哪些数据

接口以商品 PATH 为键返回商品信息，包含商品名称、规格、简介、图片、原价、当前售价以及是否处于促销中：

{
    "code": 0,
    "data": {
        "PATH1": {
            "title": "测试商品",
            "sku": "规格",
            "desc": "软件简介",
            "images": "url",
            "original_price": 12,
            "price": 2,
            "is_promotion": true
        }
    },
    "msg": ""
}

有了 original_price、price 和 is_promotion，您可以很方便地在页面上渲染划线原价、促销价和「限时优惠」角标，促销开始与结束都无需再改动前端代码。

使用建议

• 批量查询：渲染商品列表时一次性传入 PATH 数组，避免多次请求
• 价格统一维护：价格全部由后台维护，前端不再硬编码，减少上下架和调价失误
• 与支付按钮配合：查询到的商品可直接配合 data-apsdai-checkout 按钮完成下单闭环

完整的参数说明与字段释义，请查看帮助中心文档：支付接口自定义参数。