面向印尼商家的 API 优先支付基础设施实用指南

"API 优先"指 API 是使用产品的主要方式，其他一切（包括控制台）都建立在同一份记录之上。对支付而言，这意味着您的结账页面、App 和后台都连接到同一个系统，不再依赖有人手动抄写数字。

为什么适合印尼商家

印尼的在线商家常常同时通过多个渠道销售：网站、App、电商平台店铺，有时还有聊天店铺。使用 API 优先的支付平台：

• 每个渠道都用同样的方式、以您自己的订单号创建付款；
• 每个渠道都通过带签名的 Webhook 以同样的方式获知付款结果；
• 财务团队在一个地方查看所有付款，总额、手续费和净额完全一致。

五步规划集成

1. 梳理流程。 写下付款从哪里发起（结账、账单、充值），以及付款成功、失败或过期时需要做什么。

2. 确定订单号。 使用您自己的订单号作为 merchant_reference。它把 PAYWISE 和您的系统关联起来，也能防止重复：再次发送会返回同一笔付款。同时发送 customer_id（用户 ID、用户名或邮箱），以便知道是谁付的款。

3. 决定客户的付款方式。 可以在自己的页面上展示二维码或 USDT 地址，也可以把客户跳转到已处理好倒计时和状态更新的 PAYWISE 付款页面（checkout_url）。后者开发更快。

4. 先做 Webhook。 在开发结账界面之前先构建并测试 Webhook 处理程序。它决定订单是否已付款，最值得用心。请验证每一个签名。

5. 测试后上线。 在沙盒中运行所有场景（包括失败场景），然后把 pw_test_ 密钥换成 pw_live_ 密钥。

安全基础

• API 密钥只保存在服务器上，绝不放在 App 或浏览器中。
• 在 API 密钥页面将每个密钥限制为您服务器的 IP 地址。
• 为团队开启双重验证登录，并只给每个人所需的角色。
• 不要仅凭客户的返回网址就把订单标记为已付款：请等待 Webhook，或通过 API 查询交易。

没有开发人员？从插件开始

如果您使用 WooCommerce，PAYWISE 插件无需编码即可在结账时提供 QRIS 和 USDT。开发者页面上的 PHP 和 Node.js SDK 能让自定义集成更简短。

准备好之后，API 文档包含所有接口、字段和错误码。