開發人員一個 API。
一個 API。
每個收單方。
一次性整合。Cardflo 會透過我們的收單網絡路由每筆交易，當您新增供應商時無需額外代碼，當路由變動時亦不會出現破壞性變更。
create-payment.ts
// Create a payment, one API, every acquirer
const payment = await cardflo.payments.create({
amount: 4999, // £49.99
currency: "GBP",
customer: { id: "cus_8aF2..." },
method: { type: "card", token: "tok_live_..." },
// Smart routing picks the best acquirer automatically.
routing: { strategy: "approval_then_cost" },
});
if (payment.status === "approved") {
// Webhook payment.succeeded will follow.
}工具包
您快速交付支付方案所需的一切 。
REST API
可預測的資源、冪等寫入和無處不在的 JSON。
託管式結帳
一鍵嵌入，經 PCI 範圍限定，可依您品牌進行主題化。
網絡鉤子 (Webhooks)
每筆支付、退款和爭議的簽署事件。
託管與網絡代幣
具備代幣生命週期管理的便攜式客戶卡。
伺服器 SDKs
Node、Python、Go 和 PHP，內建重試功能的類型安全客戶端。
外掛程式
WooCommerce、Magento、Shopify 和 Salesforce Commerce Cloud。
網絡鉤子 (Webhooks)
每個支付生命週期的 實時事件。
經過簽署、以指數退避重試，並按事件 ID 達到冪等。訂閱您感興趣的內容，忽略其餘內容。
- payment.succeeded由已路由的收單方捕獲
- payment.retried軟性拒絕，下一個收單方
- payment.failed所有路由均已耗盡
- refund.created已啟動捕獲
- dispute.opened已收到退單
- payout.completed已結算至您的銀行
Cardflo提供REST API、webhook流、託管結賬iframe和不斷增長的即插即用組件庫。所有內容都經過版本控制, 默認冪等, 無論您整合一個還是五個收單機構, 都涵蓋相同的基本元素。文檔、沙盒密鑰和Postman集合均可公開獲取。
團隊如何整合
託管結賬
最快的生產路徑。重定向或嵌入我們的PCI範圍iframe, 完成後接收webhook。零PCI範圍, 包含錢包, 默認啟用網絡代幣。大多數整合可在一天內完成, 涵蓋90%的使用案例。
直接API
完全控制授權、捕獲、退款和爭議流程。PCI DSS SAQ D範圍。適用於文件記錄信用卡、訂閱、市場和任何需要圍繞授權的自定義邏輯的產品。支援Node、Python、Ruby、Go和PHP的參考SDK。
Webhooks和事件
冪等、重試安全、通過HMAC簽名。每個支付、退款、退單、KYB更新和結算都是一個webhook事件。沙盒允許您重播事件而無需影響生產, 從而使端到端自動化測試變得微不足道。
常見問題
常見問題
整合、SDK、webhooks、沙盒、遷移和 SLA。工程師在編寫第一行代碼之前會問的實用問題。
我是否需要為每個收單機構進行獨立整合？
不需要。一個 Cardflo REST API 和一套 webhook 便可將您連接到網絡中的所有收單機構。智能路由會為每筆交易選擇收單機構, 您無需編寫任何針對特定收單機構的程式碼。您可以在後台新增或更換收單機構, 而無需更改您的程式碼。
Webhook 和幂等性如何運作？
Webhook 透過 HMAC-SHA256 簽署, 並透過自動重試和指數退避機制傳送。每個請求都接受一個幂等性密鑰, 因此重試的創建操作會返回原始付款, 而不會重複收費。事件包括 payment.succeeded, payment.retried, refund.created 和 dispute.opened。
你們有提供 SDK 和託管的 UI 組件嗎？
有的。我們提供適用於 Node, Python, PHP, Ruby, Go 和 .NET 的伺服器端 SDK。一個即插即用的託管結帳介面、用於嵌入式卡片捕獲的 Elements, 以及用於無需編碼流程的 Payment Links API。所有 UI 組件都能減少 PCI 範圍, 讓您無需接觸卡片資料。
沙盒和測試卡片情況如何？
沙盒環境模擬生產環境, 具有適用於所有方案的測試卡片、我們支援的每個響應代碼的強制拒絕代碼, 以及模擬的 3DS 挑戰。您可以在沙盒中重播真實的生產環境 webhook, 以測試邊緣情況, 而無需影響實時流量。
我該如何從 Stripe, Adyen 或 Checkout.com 進行遷移？
支付意圖、客戶、退款和爭議都清晰地對應到 Cardflo 的等效功能, 並且我們支援在方案允許的情況下導入卡片令牌。我們提供一位遷移工程師、並排的欄位映射文件和一個預演模式, 以便在切換主要流程之前進行流量影子測試。
你們的速率限制和正常運行時間服務級別協議是什麼？
公開 API 的速率限制從每個賬戶每秒 100 個請求開始, 如有需要可提高。我們承諾交易 API 的可用性為 99.99%, 如果未達到, 將提供每月信用額度。狀態資訊可在 status.cardflo.io 查看, 包括事故歷史記錄和 RSS。