SuperAPI AI 工具集

localized-pricing

通用与其它

查看项目

更新于 10-15 21:11

技能介绍

用途:帮助开发者区分并实现 Dodo Payments 中的三种多国定价机制——本地化定价(开发者按国家/币种设定固定价格)、自适应货币(结账时按实时汇率转换)、购买力平价折扣(由 ParityDeals、Evendeals 等第三方生成折扣码)。

主要能力:每个产品有 pricing_mode,可选 by_country(按账单国家匹配本地化价格)或 by_currency(按账单币种匹配),通过 client.products.update(...) 设置,同一产品不能混用模式。本地化价格嵌套在产品下,金额以最小货币单位表示(如 USD 用美分、INR 用派士),支持创建、列出、检索、更新与归档(归档为软删除,不再用于新结账但保留历史)。自适应货币通过结账会话传入 billing_currency 启用,Dodo 按实时汇率转换基础价格,也适用于订阅创建与套餐变更。

使用方式:设置定价模式后,用 client.products.localizedPrices.create/list/retrieve/update/archive 管理价格;结账时传 billing_currency 或 billing_address.country。账单国家与币种解析顺序为:显式传入的地址/币种、客户在 Dodo 中存储的地址、IP 地理定位、回退到产品基础价格与币种;无匹配本地化价格时自动回退且不报错。套餐变更时新套餐沿用原订阅的账单国家/币种,按比例计费使用新套餐的本地化价格;税费按本地化价格而非基础价格计算,含税定价同样以本地化价格为含税总额。

适用场景:需要可控的、可预测的区域固定价格;希望结账时展示任意本地货币而无需逐一手动定价;面向新兴市场提供可负担性折扣。

限制与注意:本地化价格是静态的,不会随汇率自动更新;PPP 不是 Dodo 原生 API,需接受第三方折扣码并在结账时传入 discount_codes;启用 by_country 前应为目标市场创建本地化价格,否则回退到基础价格;同时设置本地化价格与自适应货币时,本地化价格优先。资料未提供具体收费、价格或平台支持范围等信息。