5 分鐘快速開始

從建立一把 API Key,到看到第一筆 Sandbox 付款出現在後台——這個流程你可以直接照做,全部都是真的 API 呼叫。

檢視 Markdown
想讓 AI 幫你串接?把 MCP 伺服器 加進 Claude、Cursor 或 VS Code;想看 SDK 用法,見 框架整合。

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.app

3. 建立商品與價格

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" + url

5. 在 Sandbox 完成付款

  1. 1打開上一步拿到的結帳頁網址。
  2. 2輸入 email、姓名。
  3. 3在「測試結果」選單選「成功」。
  4. 4按下確認付款,畫面會顯示「付款成功」。

6. 確認資料同步

回到商家後台的「交易」頁面,應該會看到剛剛那筆付款。這就是「Merchant 後台」與「你的串接」看到的是同一份資料——不是兩套系統。

7. 下一步:接 Webhook

上面的流程靠人眼看後台確認結果,正式串接應該改成監聽 Webhook(例如 payment.succeeded),讓你的系統即時、可靠地知道付款結果,不需要一直輪詢。