Paddle API 新增交易客户信息修订功能
Paddle API 新增"修订交易"操作,可更新已完成或已开票交易的客户、地址和商业信息,客户会收到更新后的 PDF 发票。若填入有效税号,Paddle 会创建调整以退还相应税款,原交易实体保持不变仅作记录。该功能已在 Paddle API v1 上线,属非破坏性变更,不影响现有集成。
Paddle API 新增"修订交易"操作,可更新已完成或已开票交易的客户、地址和商业信息,客户会收到更新后的 PDF 发票。若填入有效税号,Paddle 会创建调整以退还相应税款,原交易实体保持不变仅作记录。该功能已在 Paddle API v1 上线,属非破坏性变更,不影响现有集成。
Paddle 在 API v1 中新增 on_resume 字段,用于控制订阅暂停后恢复时的扣费方式,该变更为非破坏性更新,默认行为不变。此前暂停订阅会将计费周期置为 null,恢复时立即按新周期全额扣费;现在 Paddle 会保留原计费周期,设为 continue_existing_billing_period 后,若客户在原周期结束前恢复则不立即扣费。
Paddle 为 Paddle Checkout 新增繁体中文语言支持,locale 参数现可传入 zh-TW,在 Paddle.Checkout.open() 或 Paddle.Initialize() 中设置即可。
Paddle 对会产生即时扣款的订阅变更引入限制,单个订阅每小时最多 20 次、每天最多 100 次,超出后返回 429 错误。该限制按订阅计算,不限制账号整体即时扣款总量,API 的端点和字段没有变化,现有速率限制保持不变。
Paddle 开发者更新允许在创建全额调整(full adjustment)时无需指定具体交易条目,系统会自动为交易下的所有条目生成对应调整项。示例中一笔 USD 交易生成 3 条全额调整项,小计合计 582368,手续费 29507,实际收益 552861。
Paddle 更新平台,沙盒账户发出的客户邮件发件域名从 withpaddle.com 改回 paddle.com,API 端点和字段均无变化。沙盒邮件主题仍带 [TEST] 标记,便于与正式邮件区分。该变更适用于 Paddle API 版本 1,邮件内容不变。
Paddle 在 API v1 中新增越南盾(VND)作为支持的支付货币,开发者可用 VND 创建价格、折扣、交易和订阅,让越南客户以本币付款。Paddle Checkout 暂不会在开启自动货币转换时把越南价格本地化为 VND,越南结账仍默认显示 USD,除非为越南单独设置价格覆盖。该变更为非破坏性更新,不影响现有集成。
推荐理由:Paddle 新增越南盾结算,并说明自动本地化暂不覆盖越南,做越南市场的开发者可据此调整定价。
Paddle 现已支持 Alipay 的周期性交易,客户可以用 Alipay 支付订阅,平台首次扣款后会保存支付方式用于后续续费和订阅扣款。订阅续费与扣款的单笔金额上限为 1600 CNY,若应用临时折扣,折扣前总额也不能超过该上限,超出则支付失败并进入催款流程由客户更新支付信息。
推荐理由:Paddle 把 Alipay 从一次性付款扩展到订阅续费,并给出 1600 CNY 上限和审批要求,方便面向中国市场的开发者评估接入。
Paddle 平台更新后,其发出的发票会为每位客户附带虚拟账号,用于更高效地对账。该功能已于 2024 年底向现有 Paddle 平台用户推出,适用于所有按发票计费的用户,API 的端点和字段没有变化。Paddle 会自动为客户选择最优收款银行账户,例如美国客户以 USD 付款时由 Paddle.com Inc 开票并附美国银行账户信息;使用旧账户信息的付款仍可正常接收和对账,但处理时间可能更长。
Paddle 发布单页结账,客户可在同一页面填写邮箱、地址、选择支付方式并完成购买。该功能通过向 Paddle.js 传入 variant 参数启用,支持 inline 与 overlay 两种模式,取值 one-page 或 multi-page;省略时默认 multi-page,现有集成不受影响。
Paddle API 现已支持创建 customer portal sessions,生成自动登录客户门户的已认证链接,客户无需再次登录即可管理订阅、支付方式和账户信息。创建 session 时可传入 subscription_ids 数组,生成可让客户更新支付方式或取消订阅的深链。该变更在 Paddle API v1 中可用,属于非破坏性更新,不影响现有集成。
Paddle 为 Paddle Checkout 的内联结账和单页浮层结账更新了 Paddle.com 页脚,并明确展示预付与周期性费用。购买或订阅按钮上现在直接显示应付总额,订阅场景还会展示扣费频率、续费金额与下次续费日期,试用则显示试用时长。该改动已生效、无需开发者操作,属非破坏性变更,不影响现有集成和内联结账框高度。
Paddle 已接管社区贡献的 Paddle Billing Python SDK,并发布 1.0.0 版本,承诺该版本内不再有破坏性变更。SDK 已在 PyPI 上线,可用 pip 安装,功能覆盖 Paddle API 全部能力,并内置验证 webhook 签名的辅助函数,采用 Apache 2.0 许可证。
Paddle 发布保存支付方式功能,客户可在结账时勾选保存支付方式,下次购买时通过 Paddle.js 直接展示已保存的支付方式。支付方式以新的 saved payment method 实体挂在客户下,拥有以 paymtd_ 开头的独立 Paddle ID,可通过 API 列出、获取和删除,并新增保存或删除事件;客户可在 customer portal 查看和删除。
推荐理由:Paddle 新增保存支付方式能力,开发者可据此改造结账流程,减少回头客重复填写卡信息。
Paddle 更新平台,API 不再返回超过 90 天的 events 和 notifications,仅返回 created_at 在最近 90 天内的实体,查询更早数据会返回 not_found 错误。
Paddle 新增 Apple Pay 域名验证选项,验证后 Apple Pay 弹窗可直接从结账页启动,无需再经 Paddle.com 弹窗中转。未验证域名仍会通过 Paddle.com 弹窗打开 Apple Pay,验证入口在 Paddle > My account > Settings > Website approval,API 端点与字段无变化。
Paddle 平台更新后,折扣码在 Paddle API 和 Paddle.js 中不再区分大小写,此前 blackfriday、BLACKFRIDAY 和 blackFriday 会被视为不同折扣码。该变更已在 Paddle API v1 和最新版 Paddle.js 中生效,Paddle.js 自动更新,开发者无需改动实现。少数存在同码不同大小写折扣的用户已被 Paddle 直接联系。
Paddle 平台现已支持暂停处于 trialing 状态的订阅,暂停发生在计费周期结束时,即试用期结束时,且只能选择这一默认方式,无法立即暂停。该变更在 Paddle API v1 中生效,API 的端点和字段均无改动,属于非破坏性更新,不影响现有集成。
Paddle 开发者更新支持模拟单个事件或场景的 Webhook,方便开发者在本地或测试环境验证交易完成等回调逻辑。示例事件为 transaction.completed,包含 AeroEdit Pro 等产品的价格、税费与结算明细,便于核对实际回调数据结构。
Paddle 发布了一款 Next.js SaaS 订阅计费脚手架,可在 Vercel Marketplace 一键部署,也可从 GitHub 部署到其他环境,演示地址为 paddle-billing.vercel.app。
推荐理由:Paddle 官方发布订阅计费脚手架,把定价页、结账、用户管理和 webhook 同步打包成可直接部署的模板。
Paddle 平台新增 credit note(信用凭证),在你对交易发起退款或信用调整时自动以 PDF 形式发送给客户。该功能适用于 2024 年 8 月 30 日之后创建的 adjustment,此前的调整无法生成 credit note。API 新增「get a PDF credit note for an adjustment」操作,返回 PDF 链接,属于非破坏性变更,现有集成不受影响。
Paddle 发布客户门户(customer portal),为使用 Paddle 账户收款的客户提供集中管理购买记录的页面。该门户由 Paddle 托管,客户通过 magic link 登录后可查看历史付款并下载发票、查看和取消订阅、更新订阅付款信息,以及查看和更新一次性购买的已存付款方式。Paddle 发送的邮件会自动附带该门户链接,开发者无需额外配置即可使用。
Paddle 在 API v1 的「获取交易 PDF 发票」接口新增 disposition 查询参数,可传 inline 让浏览器在当前标签页内联打开 PDF,而非默认的 attachment 下载保存。该改动为非破坏性变更,不影响现有集成,现有链接的 Content-Disposition 仍为 attachment。
Vercel 现已原生集成 Supabase、Redis 和 EdgeDB,用户可免费起步或以与直购相同的价格购买存储,新增存储附加组件包含统一账单和直接访问服务商控制台。
Paddle 为 Paddle Billing 推出的官方 Go SDK 正式发布 v1.0.0,承诺该版本内不再有破坏性变更。SDK 与 Paddle API 完全对齐,提供 webhook 签名校验辅助函数,以 Apache 2.0 许可证开源,可通过 go get 安装。API 的端点和字段没有变化,从 v0 升级需参考仓库根目录的 CHANGELOG.md 和 UPGRADING.md。
Clerk 发布教程,讲解如何用 Clerk Organizations 和 Stripe 在 Web 应用中实现按用户(Per-User)计费的 B2B 变现。示例开源应用 Team Task 让用户自助创建组织、邀请成员、通过 Stripe Checkout 购买席位,并用 webhook 将 Stripe 订阅同步到 Neon 数据库的 license_count。
Paddle 更新允许向订阅中添加非目录(non-catalog)定期产品与价格,价格类型为 custom,无需预先在目录中创建。示例订阅中新增的 Reporting module 定价 $10000/月,与目录内 AeroEdit Pro($3000/月/席位)和 Analytics addon($10000/月)并列计费。
Paddle 更新平台逻辑,暂停订阅时会自动取消逾期未付的续费交易,避免恢复订阅后对两个重叠计费周期重复扣款。该改动只针对 origin 为 subscription_recurring 的续费交易,一次性扣费(subscription_charge)和立即计费的循环项目(subscription_update)不受影响。
Prisma Accelerate 已在 AWS Marketplace 上架,客户可通过 AWS 账户直接购买 Prisma 产品并统一账单。Pro 和 Business 套餐以年度订阅形式提供,年付价格含 10% 折扣,Pro 用户可享 Business 套餐的用量价格,但无免费试用。购买后账单走 AWS,账户与资源仍在 Prisma Data Platform 管理,功能与直接购买一致。
Resend 现已支持在 Dashboard 内管理订阅与账单信息,用户可随时升级、降级或取消订阅,查看并下载 PDF 格式的发票。用户还能添加账单地址、账单邮箱和 VAT ID 等税务信息,并直接更新信用卡等支付方式,无需离开 Dashboard。
Railway 的 Template Kickback 计划现在支持把模板返现收益兑换成美元,按模板在平台上产生的算力消费给予 25% 返现,无上限。提现通过 GitHub Sponsors 或 Buy Me a Coffee 进行,最低提现额为 100 美元,此前返现默认自动转为 Railway Credits 抵扣账单。
推荐理由:Railway 把模板返现从平台积分改成可提现美元,并给出提现门槛与通道,做模板的人可据此判断收益能否落袋。
ShipAid 是一款 Shopify 应用,让卖家为丢失、被盗或损坏的包裹提供保障,创始人 Stefan Alexiev 称 70% 的顾客会选择加购配送保障,结账时清晰说明保障权益可把转化率提升超 20%。
Paddle 开发者更新中,订阅项目(subscription items)现在可返回关联的产品信息。以 AeroEdit Pro 为例,订阅项会附带产品名称、描述、功能开关(如航线规划、合规监控)及建议加购项等字段。该订阅含 10 个席位、单价 $30/月,另加 1 个 Analytics addon、单价 $100/月,均按月计费。
Paddle 更新平台,在变更订阅计费周期时新增 do_not_bill 作为 proration_billing_mode 的可选值,Paddle 不再计算按比例费用也不再向客户收费。
Paddle 更新平台退款审批机制:沙盒账户的退款每十分钟自动从 pending_approval 变为 approved,方便测试审批流程;正式账户在满足账户已通过 Paddle 审核且处于活跃状态、退款金额不超过 400 USD 或等值货币、退款金额低于账户余额、原支付方式非银行或电汇转账这四项条件时自动批准。
推荐理由:Paddle 调整退款审批规则,沙盒每十分钟自动通过,正式账户满足四项条件即自动批准。
Clerk 开发者用 Custom flows 和 Stripe Elements 构建了一个单页注册表单,用户输入邮箱、选择套餐并填写信用卡信息后,通过邮箱 OTP 验证即可自动开通所选套餐试用。信用卡信息经 Stripe Elements 生成 token,套餐与支付信息暂存于 Clerk 的 unsafe metadata,验证通过后账户创建并同步注册 Stripe 订阅。
Paddle 在平台余额币种中新增澳大利亚元(AUD)和加拿大元(CAD),此前仅支持美元、欧元和英镑。AUD 和 CAD 现在也可作为 adjustments 中原始拒付费用的取值。
推荐理由:Paddle 新增 AUD 和 CAD 余额币种,用澳元或加元收款的开发者可减少结算时的汇兑费用。
Paddle 为 Paddle.js 的 Paddle.Checkout.open() 和 Paddle.Initialize() 新增 allowDiscountRemoval 参数,并配套 HTML 属性 data-allow-discount-removal,默认值为 true。
Hugging Face 组织账号现在可通过 AWS Marketplace 订阅 Enterprise Hub,账单直接由 AWS 账号管理,价格与 Hugging Face 公开定价一致。
Paddle 为 Paddle Billing 发布 Go SDK 预发布版,已在 GitHub 上线,可通过 go get 安装。该 SDK 覆盖 API 核心操作,包含验证 webhook 签名的辅助函数,采用 Apache 2.0 许可,完整功能对齐仍在开发中。API 的端点和字段没有变化。