應用市集
附加元件 v1.0.14

Wallet payments

總覽

連接到 PayPal。你的顧客在 PayPal 頁面上,以自己的 PayPal 帳戶支付一張發票或任何帶金額的記錄。顧客在那裡核准付款後返回;接著 Adminium 收取這筆款項(PayPal 稱之為「擷取」),並記到這筆記錄上,只記一次。如果顧客一直沒有返回,就由 Webhook 或 Adminium 自己的核查來收取;被 PayPal 暫扣的付款會顯示為「處理中」,並附上 PayPal 提供的原因。賣家是你的商店:它需要自己的 PayPal 商家帳戶,款項從顧客直接進入這個帳戶。Adminium 不持有任何付款帳戶、任何自己的憑證,也不經手任何款項,不處理任何交易;顧客在 PayPal 頁面上輸入的任何內容都不會到達你的伺服器。在 Studio → 付款 中設定,先用沙盒:每種模式各一個附用戶端 ID 與密鑰的 REST 應用程式和一個 Webhook,然後以沙盒買家身分做一筆測試付款,它不會向你的資料表寫入任何內容。退款可以在記錄的付款面板或「動態」中發起,在 PayPal 主控台做的退款也會被記錄。有爭議的付款會持續追蹤,直到 PayPal 作出裁決;你在 PayPal 主控台回覆爭議。它只提供一種付款方式,即顧客的 PayPal 帳戶,支援 PayPal 支援的 24 種貨幣,其中 HUF、JPY 與 TWD 只能以整數單位收取。需要 Adminium 0.3.33 或更新版本,並使用 443 連接埠上的公開 https 位址,PayPal 只向這個連接埠傳送 Webhook。

它依附在什麼上

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

連線之後它可以做什麼

它需要你自己的 PayPal 商家帳戶中的一個 REST 應用程式,沙盒與正式模式各一個:它的用戶端 ID、密鑰與它的 Webhook 的 ID。這個密鑰能打開整個 PayPal 帳戶(PayPal 沒有權限更窄的金鑰),所以三者都依模式分別加密保存在你的伺服器上,附加元件的任何部分都不會到達瀏覽器。每個 Webhook 的簽章都在你的伺服器上以 Webhook ID 驗證。付款只會寫入你在「可付款的內容」中選定的資料表裡的資料列。它的伺服器部分只能呼叫下面六個位址,別無其他。

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

  • api-m.paypal.com
  • api-m.sandbox.paypal.com
  • www.paypal.com
  • www.sandbox.paypal.com
  • api.paypal.com
  • api.sandbox.paypal.com

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

連線時需要什麼

一組 API 金鑰

它增加了什麼

它出現在哪裡 3
  • 在 Adminium 中:Studio → 付款 → 設定 下它的卡片,附有清單:沙盒應用程式、沙盒 Webhook、傳送測試付款、正式應用程式、正式 Webhook、第一筆正式付款已入帳
  • 在記錄的付款頁面上:「使用 PayPal 付款」,把顧客帶到 PayPal 頁面
  • 在記錄的付款面板與「動態」中:它收取的付款,以及相關的退款與爭議
它帶來的資料表 0

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

需要設定的項目 3
  • 用戶端 ID
  • 密鑰
  • Webhook ID

如果你把它關掉

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

會留下什麼

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

會消失什麼

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

關於示範

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

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

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