兩種串接模式
選擇直接控制金流,或使用 PayCore 託管的 All-in-One 付款頁。
Direct Gateway API 適合每次由商戶系統帶金流憑證產單;Project Checkout API 適合商戶把憑證存在 PayCore 後台,只用收款專案 API Key 建立付款。
Direct 與 All-in-One 差異
兩種模式可以同時存在。Direct Gateway API 保留商戶系統的最大控制權;All-in-One 付款頁則讓 PayCore 成為付款方式選擇與金流編排入口。
Direct Gateway API
不把金流 Key 存到 PayCore
商戶系統指定某一家金流與付款方式,並在產單 request 裡帶入該金流需要的憑證。
- Endpoint:POST /api/paycore/pay/{gateway}/{method}
- 憑證欄位:gateway_credentials
- 適合單一金流或工程主導串接
Project Checkout API
儲存金流 Key,改用 PayCore 收款專案 Key
商戶先建立 PayCore 收款專案,並把多組金流憑證綁到專案底下。之後商戶系統只需要用 PayCore project_api_key 產單。
- Endpoint 草案:POST /api/paycore/checkout
- 憑證欄位:project_api_key
- 適合 PayCore 託管 All-in-One 付款頁
All-in-One 付款流程
商戶在 PayCore 商戶中心建立收款專案
商戶綁定速買配、綠界、PLUS、Stripe 等金流憑證
商戶系統使用 project_api_key 建立付款
PayCore 回傳 checkout_url
付款者在 PayCore 付款頁選擇付款方式
PayCore 使用專案綁定的金流憑證建立實際金流付款
金流回呼 PayCore Webhook
PayCore 更新付款狀態並通知商戶 notify_url
PayCore 开发者中心已正式公开,文件会持续补齐 Direct Gateway API、All-in-One 收款项目、Webhook 与错误码范例。