開發者

為開發者而設。

建立付款、管理退款、接收交易更新，並將支付營運直接融入您的產品。

POST/api/v1/payments

curl "$RAINBOWPAY_API_BASE/api/v1/payments" \
  -X POST \
  -H "Authorization: Bearer YOUR_PRIVATE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product": "Order RP-10428",
    "amount": 125000,
    "currency": "HKD",
    "orderNumber": "RP-10428",
    "callbackUrl": "https://merchant.example/payments/callback",
    "redirectSuccessUrl": "https://merchant.example/checkout/success",
    "redirectFailUrl": "https://merchant.example/checkout/failed",
    "locale": "en"
  }'

整合所需的一切

API 概覽資源、驗證、慣例及錯誤。測試環境在不涉及真實資金的情況下開發及測試。Webhooks在您的伺服器上接收狀態變更。

密鑰只存於您的伺服器

每次調用均經 HTTPS 以 Bearer 令牌形式發送私人密鑰進行驗證。切勿將密鑰嵌入瀏覽器或流動應用程式。

獨立環境

測試環境與正式環境使用不同的憑證。正式環境的使用權限須經合規、商業及技術批核後方可取得。

完整參考資料

參數、回應格式、錯誤代碼及付款狀態均載於 docs.rainbowpay.hk。

生命週期

由請求到回調。

商戶伺服器
以您的私人密鑰建立付款。
POST /api/v1/payments
彩虹匯 API
驗證請求並返回付款令牌。
200 · token
付款處理
客戶付款；如有需要，會進行驗證。
結果
付款達至最終狀態。
approved | declined
回調
狀態發送至您的回調 URL。
POST callbackUrl

整合指南

託管收銀台（Hosted Checkout）整合將客戶轉至由彩虹匯託管的付款頁面，並於您的伺服器接收付款結果。銀行卡資料於託管頁面輸入，而非您的網站。伺服器對伺服器 API 付款透過彩虹匯 API 直接從您的伺服器建立及管理付款，包括兩步付款及退款。處理回調於您的伺服器接收付款狀態變更並安全處理，即使通知重複、延遲或不按次序送達亦然。定期付款在客戶在場時收取首次付款，其後以定期付款令牌收取重複付款。

準備好商討您的支付設定了嗎？

請告訴我們您的業務目前如何收款，以及您對下一個支付整合有何需要。

開始申請聯絡銷售團隊