5 分鐘快速開始
從建立一把 API Key,到看到第一筆 Sandbox 付款出現在後台——這個流程你可以直接照做,全部都是真的 API 呼叫。
1. 建立一把測試金鑰
商家後台 →「開發者」→「API 金鑰」,建立一把有 products:write、prices:write、payment_links:write scope 的金鑰。細節見 取得 API Key。
2. 設定環境變數
REBATE_PAY_API_KEY=rbp_test_...
REBATE_PAY_BASE_URL=https://revopay-dev.zeabur.app3. 建立商品與價格
curl -sS -X POST "$REBATE_PAY_BASE_URL/api/Product" \
-H "Authorization: Bearer $REBATE_PAY_API_KEY" -H "Content-Type: application/json" \
-d '{"name":"我的第一個商品"}'
# 拿到回應裡的 product id 之後:
curl -sS -X POST "$REBATE_PAY_BASE_URL/api/Price" \
-H "Authorization: Bearer $REBATE_PAY_API_KEY" -H "Content-Type: application/json" \
-d '{"productId":"prod_...","currency":"TWD","amount":200,"type":"OneTime"}'TWD 沒有小數位:
amount 是台幣金額本身(200 = NT$200),不是分為單位的整數。4. 建立 Payment Link,導去 Hosted Checkout
最簡單的收款方式:建立一個 Payment Link,把顧客導去 ReBate Pay 代管的結帳頁——你完全不用自己做收銀台介面。
curl -sS -X POST "$REBATE_PAY_BASE_URL/api/PaymentLink" \
-H "Authorization: Bearer $REBATE_PAY_API_KEY" -H "Content-Type: application/json" \
-d '{"name":"我的第一筆收款","priceId":"price_..."}'
# 回應會有 url: "/pay/{token}" —— 把顧客導去 "$REBATE_PAY_BASE_URL" + url5. 在 Sandbox 完成付款
- 1打開上一步拿到的結帳頁網址。
- 2輸入 email、姓名。
- 3在「測試結果」選單選「成功」。
- 4按下確認付款,畫面會顯示「付款成功」。
6. 確認資料同步
回到商家後台的「交易」頁面,應該會看到剛剛那筆付款。這就是「Merchant 後台」與「你的串接」看到的是同一份資料——不是兩套系統。
7. 下一步:接 Webhook
上面的流程靠人眼看後台確認結果,正式串接應該改成監聽 Webhook(例如 payment.succeeded),讓你的系統即時、可靠地知道付款結果,不需要一直輪詢。
ReBate Pay Docs