開發中
Idempotency
寫入請求帶 Idempotency-Key，避免重複建立 Checkout 或訂閱。契約方向，尚未正式上線。
開發者文件
先把 Billing API 講清楚，再決定要不要接
這頁說明 ReBate Pay 長期維持的開發者契約：金鑰、權限範圍、冪等、Webhook 與 MCP。完整 API 參考請看開發文件。
可使用 /v1 API、OpenAPI、TypeScript SDK、MCP 伺服器與帳務工具。標示開發中的項目尚未正式上線；第三方登入開發中。
curl -X POST https://api.rebate-pay.com/api/PaymentLink \
-H "Authorization: Bearer sk_test_..." \
-H "Idempotency-Key: plink_01HEXAMPLE" \
-H "Content-Type: application/json" \
-d '{
"priceId": "price_pro_monthly",
"name": "Pro plan",
"successUrl": "https://app.example.com/ok"
}'以下為呼叫範例，請把金鑰換成你自己的。
穩定 contract
先對齊介面，再談上線時程
API 金鑰
每把金鑰都有明確的權限範圍，只在建立時顯示一次，可隨時撤銷或輪替。
Scopes
未來以最小權限授權，例如 billing:read、checkout:write。尚未 Production。
Webhook events
subscription.created、payment.succeeded 等事件目錄，每個事件都有簽章，可驗證來源。
Webhook retry
失敗自動重試、投遞紀錄可查，也能手動重送。
Webhook logs
商家後台可查看本機事件與紀錄。正式遠端投遞日誌仍在規劃。
測試與正式
測試與正式資料完全隔離，測試金鑰不會動到正式資料。
開發中
SDK
TypeScript SDK 可用；Python SDK 開發中。任何語言都可以直接呼叫 REST API。
開發中
Web Components
可嵌入的結帳與顧客入口元件開發中。
開發中
MCP / AI
標準 MCP 伺服器（/mcp）：把網址加進 Claude、Cursor、VS Code，AI 就能讀文件、查 API 規格、操作沙盒資料並寫好串接程式；高風險操作需人工核准。
Webhook 事件方向
先對齊事件名稱，投遞與重試另標狀態
- subscription.created
- subscription.canceled
- invoice.paid
- payment.succeeded
- payment.failed
- customer.updated
測試與正式
同一套產品，兩套資料，不要混用金鑰
Test
預設環境。測試資料與測試金鑰，用來走完 Checkout 與 Webhook 流程。
Live
正式環境預覽。切換後仍不會對真實持卡人扣款。
金鑰、顧客與交易不會跨模式共用。