應用市集
附加元件 v1.0.14

Card payments

總覽

連接到 Stripe。你的顧客在 Stripe 頁面上,以卡片及你的 Stripe 帳戶提供的其他方式,支付一張發票或任何帶金額的記錄。Stripe 一確認付款成功,付款就記到 Adminium 中的這筆記錄上,而且只記一次,無論先發現它的是 Webhook 還是 Adminium 自己的核查。賣家是你的商店:由它開立自己的 Stripe 帳戶、建立自己的金鑰,款項從顧客直接進入這個帳戶。Adminium 不持有任何付款帳戶、任何自己的金鑰,也不經手任何款項,不處理任何交易;顧客只在 Stripe 頁面上輸入卡片資料,因此沒有任何卡號會到達你的伺服器。在 Studio → 付款 中設定,先用測試模式:每種模式各一組受限金鑰和一個 Webhook,然後用 Stripe 測試卡做一筆測試付款,它不會向你的資料表寫入任何內容。退款可以在記錄的付款面板或「動態」中發起,在 Stripe 主控台做的退款也會被記錄。有爭議的付款會被標記並追蹤到爭議結束;你在 Stripe 主控台回覆爭議。它不儲存卡片、不支援訂閱,也不把付款表單放到你自己的頁面上;BHD、JOD、KWD、OMR、TND 與 UGX 的付款暫不支援線上收取。需要 Adminium 0.3.33 或更新版本,並使用公開的 https 位址。

它依附在什麼上

這一個不綁定某個應用程式。它在 Adminium 本身中運作,也在任何承載附加元件的應用程式中運作。

連線之後它可以做什麼

它需要你自己的 Stripe 帳戶提供兩樣東西,測試模式與正式模式各一份:一組受限金鑰(rk_…;秘密金鑰會被拒絕)和 Webhook 的簽章密鑰。兩者依模式分別加密保存在你的伺服器上,附加元件的任何部分都不會到達瀏覽器。這組金鑰只獲得設定卡片列出的權限:發起付款並結束不再需要的付款、讀取付款的結果與實收金額、退款(在 Stripe 中,這項權限也允許修改扣款)、讀取事件與爭議、你開啟的付款方式,以及金鑰屬於哪個帳戶。付款只會寫入你在「可付款的內容」中選定的資料表裡的資料列。它的伺服器部分只能呼叫下面兩個位址,別無其他。

它的伺服器程式碼可以連到的位址

  • api.stripe.com
  • checkout.stripe.com

這份清單就是全部:連到其他位址會被拒絕並記錄下來。

連線時需要什麼

一組 API 金鑰

它增加了什麼

它出現在哪裡 3
  • 在 Adminium 中:Studio → 付款 → 設定 下它的卡片,附有清單:測試金鑰、測試 Webhook、傳送測試付款、正式金鑰、正式 Webhook、第一筆正式付款已入帳
  • 在記錄的付款頁面上:你的 Stripe 帳戶已開啟的付款方式,每一種都會把顧客帶到 Stripe 頁面
  • 在記錄的付款面板與「動態」中:它收取的付款,以及相關的退款與爭議
它帶來的資料表 0

沒有 —— 它不帶自己的資料表。

需要設定的項目 2
  • 受限金鑰
  • Webhook 簽章密鑰

如果你把它關掉

中斷連線會移除附加元件的畫面。它絕不會刪掉自己建立的資料表、寫入的檔案或新增的紀錄 —— 它寫下的一切都留在你的資料庫裡。 交給它的憑證會隨之被撤銷並刪除。

會留下什麼

已記錄的每一筆付款與退款都會保留:在對應的記錄上、在「動態」裡,以及你選定的自有付款資料表中(如果你選了的話)。它沒有帶來自己的資料表。手動付款方式與手動記錄付款照常可用,你的 Stripe 帳戶及其中的款項不受任何影響。

會消失什麼

它卡片上的「中斷」提供兩種做法。停止新付款:不再發起新的付款,Adminium 保留金鑰,用來完成仍在等待的付款並辦理退款。刪除金鑰:金鑰從這台伺服器上刪除,Adminium 無法再透過 Stripe 完成付款或辦理退款。在此刪除金鑰不會在 Stripe 作廢它;為安全起見,請在 Stripe 主控台中更換金鑰。

關於示範

本站的任何示範都不會真的呼叫別人的服務。每個附加元件都自帶一個替代傳輸層,回應來自內建資料,而且預設就是開著的。真正的憑證屬於自行架設的選擇,寫在該附加元件自己的 README 裡。

如何開啟它 本網站上的示範都不包含它。在你自己的 Adminium(0.3.33 或更新版本)裡,在「附加元件」中安裝 Card payments,開啟 Studio → 付款,依它卡片上的清單操作,先用測試模式。每個測試付款頁面也提供示範服務,完全不需要帳戶,因此在連接任何東西之前,就能試完整個流程,包括退款。

Adminium 與該公司沒有任何關係。