API 對接 — AnyPay | XFinTech Asia

何時需要 API 對接？

場景	網頁門戶	API 對接
月交易 < 50 筆，人工審單	✓ 推薦	非必需
ERP/商城自動化	效率低	✓ 推薦
平台商管理百家子商戶	✓ 可並用	✓ X-Unit-Id
SaaS 訂閱自動扣款	—	✓ 必需
Webhook 狀態回寫	登入查看	✓ 實時推送

API 模組一覽

Account & KYB

企業認證、帳戶查詢、錢包餘額、子商戶創建

Collection

收款帳號申請、入賬查詢、店鋪/訂單管理

Payout

收款人管理、單筆/批量出款、狀態查詢

FX & Settlement

換匯、結匯、額度查詢

Acquiring

收卡訂單、收銀台、訂閱管理

Issuing

企業卡開卡、充值、凍結、交易查詢

Webhook

入賬、付款、KYB、收卡等事件推送

Transfer

帳戶間劃轉、平台商資金歸集

Developer

API Key、Sandbox、簽名驗證、幂等鍵

平台商必讀：X-Unit-Id

平台商 API 請求必須帶 X-Unit-Id 標頭，指定業務歸屬的子商戶。忘帶或帶錯會導致資金記到錯誤帳戶——這是平台商對接最常見的坑。

// 示例：為子商戶創建收款訂單
POST /v1/collection/orders
Headers:
  Authorization: Bearer sk_live_xxxx
  X-Unit-Id: unit_merchant_abc123
  Idempotency-Key: order-20260301-001

Body:
{
  "amount": "10000.00",
  "currency": "USD",
  "reference": "INV-2026-001"
}
      

Webhook 事件

AnyPay 主動推送業務結果到您的服務器。請實現幂等處理——同一事件可能重試推送。

collection.credited收款入賬 · 待結算餘額更新

payout.completed付款成功 · 出款到帳

payout.failed付款失敗 · 需人工或重試

kyb.approved企業 KYB 審核通過

kyb.rejected企業 KYB 審核拒絕 · 附原因

acquiring.payment.succeeded線上收卡成功

issuing.card.created企業卡開卡完成

fx.conversion.completed帳內換匯完成

完整 API 文檔（中文） English Docs

安全機制

簽名驗證

Webhook 請求帶 HMAC-SHA256 簽名，商戶端驗簽後處理，防止偽造。

幂等鍵

出款、換匯等寫操作支援 Idempotency-Key，避免網絡重試導致重複執行。

Sandbox 環境

完整測試環境，模擬入賬、付款、Webhook 推送，上線前充分驗證。

IP 白名單

可配置 API 調用來源 IP，配合 2FA 與支付密碼多層防護。

Open API · 可選但強大