如何通过 PAYWISE 接收 QRIS 付款

QRIS 是印度尼西亚的国家二维码标准。同一个二维码可以用印尼任何银行或电子钱包 App 支付，客户无需安装特定 App。通过 PAYWISE，您只需一次 API 调用即可生成二维码，并在付款成功的第一时间收到通知。

开始之前

您需要一个 PAYWISE 账户和一个 API 密钥。请先创建沙盒密钥（以 pw_test_ 开头）：它的用法与正式密钥完全相同，但不会产生真实资金流动。密钥在控制台的 API 密钥页面创建。完整密钥只显示一次，请妥善保存。

第 1 步：创建付款

客户结账时，由您的服务器创建一笔交易：

curl -X POST https://paywise.asia/api/v1/transactions \
  -H "Authorization: Bearer pw_test_..." \
  -H "Content-Type: application/json" \
  -d '{"merchant_reference":"ORDER-1001","customer_id":"user-42","amount":150000,"payment_method":"QRIS"}'

• merchant_reference 是您自己的订单号。如果请求超时后重新发送，PAYWISE 会返回原来的交易，而不会重复创建。
• customer_id（必填）是您系统中的客户 ID，例如用户 ID 或邮箱，便于查看是谁付的款。
• amount 以整数印尼盾计，每笔 1,000 至 10,000,000。
• expires_in（可选）设置二维码的有效支付时间，60 至 1,200 秒（默认值）。

第 2 步：展示二维码

API 响应中包含二维码数据。您可以在自己的页面上绘制二维码，也可以直接将客户跳转到 checkout_url：这是 PAYWISE 托管的付款页面，包含二维码、倒计时和自动刷新的付款状态。付款页面在控制台中按网站开启。

第 3 步：通过 Webhook 确认付款

客户使用银行或电子钱包 App 扫码付款后，PAYWISE 会向您的服务器发送 payment.paid Webhook。请在验证签名后，以该 Webhook 为准完成订单，而不是以客户返回您网站为准：任何人都可以手动输入返回网址。

具体做法请阅读验证 Webhook 签名。

第 4 步：正式上线

沙盒测试通过后，创建正式密钥（pw_live_...）替换沙盒密钥即可，代码无需修改。已付款的 QRIS 交易每天分批结算，可提现到您的银行账户，详见结算与提现说明。

小提示

• 只有付款成功的交易才收取手续费，待付款、失败和过期的交易均不收费。当前费率请见价格页面。
• 每次 API 调用都会连同状态和请求 ID 记录在控制台中，排查问题十分方便。
• 完整参考请见 API 文档。