方案與付款

方案預設關閉，關閉時伺服器不做任何限制。方案需要帳號模式。在 /admin 的方案與付款下開啟方案與限制，再到方案設定每個方案允許的內容：

每個群組的收據照片與每個群組的定期支出；
一個帳號加入的群組（不論是誰建立的），以及每個群組的人數；
分享方案的群組：一個帳號能讓多少個群組套用自己的方案；
付款提醒：群組裡的人能不能用通知提醒欠款的人。透過其他 App 分享提醒訊息永遠免費；方案關閉時，每個人都能傳送通知提醒。

限制留空代表不限。恰好一個方案是預設方案，套用在沒有其他方案的每個帳號上。帳號有多個方案時，使用順位最高的那個。

記帳本身永遠免費：支出、分帳、結清、統計、CSV 匯出、推播與即時更新都不受限制。新的限制只會擋下之後新增的內容，方案結束時也不會刪除任何東西。

群組的限制來自把方案分享給它的成員，只要對方仍是成員、方案仍有效。否則就使用預設方案。Settle Up 匯入的人數若超過預設方案允許的上限，從一開始就會套用匯入者的方案。

Ko-fi

把 Ko-fi 頁面設為你的 https://ko-fi.com/... 網址。
在 Ko-fi 的 webhook 設定中，把網址填為 <公開網址>/api/v1/webhooks/kofi。/admin 會顯示確切的網址。公開網址必須是 https://。
把 Ko-fi 的驗證權杖複製到 Ko-fi 驗證權杖。設定之前，webhook 一律回應 404。
在你的 Ko-fi 商店中，為每種販售的期間新增一個商品，例如 90 天與 360 天。
在方案下，為每個商店商品新增一個付款方式為 Ko-fi 的商品。它的商店商品代碼是商品連結的最後一段 ko-fi.com/s/<代碼>，天數則是這個商品的有效天數。一次買多個同樣的商品時，每個都會加上它的天數。
若也要接受打賞，請新增一個沒有商店商品代碼的商品。它對應金額至少達到它、幣別相同的打賞；有多個時，以打賞金額能達到的最高門檻為準。

付款時，付款人在你的 Ko-fi 頁面購買其中一個商店商品，或送出打賞。接著在 App 的方案頁面打開加入 Ko-fi 款項，輸入 Ko-fi 收據上的交易 ID，或含有它的連結。每筆付款會把它的天數加到剩餘天數上。

付款紀錄列出 Ko-fi 送來的所有付款。待認領代表還沒有人加入它，未對應代表沒有符合的商品；兩者都可以用提供給帳戶手動處理。Ko-fi 不會回報退款：退款給某人後，請到帳戶撤銷他的方案。

PayPal

在 developer.paypal.com 為你的 PayPal 商家帳戶建立一個 REST 應用程式。在方案與付款下，把它的用戶端 ID 貼到 PayPal 用戶端 ID，密鑰貼到 PayPal 密鑰。
在該應用程式新增一個 webhook，網址填 <公開網址>/api/v1/webhooks/paypal（/admin 會顯示確切的網址），並勾選這些事件：CHECKOUT.ORDER.APPROVED、PAYMENT.CAPTURE.COMPLETED、PAYMENT.CAPTURE.REFUNDED、PAYMENT.CAPTURE.REVERSED、PAYMENT.CAPTURE.DENIED、PAYMENT.SALE.COMPLETED，以及所有 BILLING.SUBSCRIPTION.* 事件。公開網址必須是 https://。
把 webhook 的 ID 複製到 PayPal Webhook ID。用戶端 ID、密鑰與 webhook ID 都設定之前，PayPal 不會開啟。
在方案下，為每樣販售的東西新增一個付款方式為 PayPal 的商品。它的方案 ID 或名稱決定它是什麼：
- PayPal 訂閱方案的 ID（以 P- 開頭）會讓它成為訂閱。價格由 PayPal 設定，只要訂閱持續付款，方案就一直有效。
  - 若 PayPal 方案有免費試用，請把無試用期的方案 ID 設為同一個方案但沒有試用期的 ID。PayPal 會讓每筆新訂閱都有試用，所以試用過的帳戶會改訂那個方案。每個帳戶只有一次試用期間能取得權限。
- 其他任何名稱都會讓它成為單次付款，金額與幣別依商品設定，付款後把它的天數加到剩餘天數上。

若想先試用，請開啟 PayPal 沙盒並使用沙盒應用程式的憑證：不會真的付款。

付款人在 App 的方案頁面點選其中一個方案，在 PayPal 付款後回到 App，App 會告知付款是否成功。伺服器會向 PayPal 查證每筆付款，不採信其他來源。訂閱者可以在 paypal.com 變更或取消訂閱，管理 PayPal 訂閱會打開那裡。

PayPal 會回報退款與撤回：該筆付款在付款紀錄中會顯示為已退款，它給的時間也會收回。

只有網頁版，以及設定為允許外部付款的 Android 建置（見 Android 正式版建置），會顯示 Ko-fi 與 PayPal。其他版本只顯示方案與它的限制。

Google Play

只有 App 的 play 建置會販售 Google Play 訂閱（見 Android 正式版建置），而且只限你上架時使用的套件名稱。

在 Play Console 建立訂閱，並為每個訂閱啟用一個基本方案。
在 Google Cloud 建立一個服務帳號及它的 JSON 金鑰。在 Play Console 的使用者和權限下邀請它，並給予查看財務資料、管理訂單和訂閱的權限。
在方案與付款下設定 Google Play 套件名稱，並把金鑰貼到 Google Play 服務帳號。兩者都設定後，Google Play 就會開啟。
在方案下新增商品，付款方式選 Google Play，填入 Play Console 中的產品 ID，以及它購買的方案。Google Play 會告知每筆付款何時結束，因此商品沒有自己的天數。
若要讓續費與取消自動送達，請建立一個 Pub/Sub 主題，給 [email protected] 該主題的 Pub/Sub 發布者角色，再到 Play Console 的營利設定填入這個主題。接著新增一個推送到 <公開網址>/api/v1/webhooks/play 的推送訂閱，開啟驗證，以同一個網址作為目標對象，並使用你自己的服務帳號；把那個帳號的電子郵件填為 Pub/Sub 推送帳號。沒有這些設定時，續費只會在擁有者打開方案頁面時才送達。

伺服器會向 Google 查證每筆購買，不採信其他來源，因此在 Play Console 做的退款與撤銷也會同樣送達。在帳戶撤銷方案後，即使 Google 再次回報該筆購買，撤銷仍然有效，但這不會停止訂閱：請一併在 Play Console 取消。

付款紀錄

每筆付款都會保存付款人的電子郵件與名稱。設定 BALNANA_PAYMENT_KEEP_DAYS 後，它們會在那麼多天後清除；金額、日期與方案則會保留，即使帳號已刪除。之後未認領的付款只能用交易 ID 認領。請依你所在國家對銷售紀錄的要求決定天數，並寫在你的隱私權政策中。未設定或設為 0 時，會永久保存。

設定

除了最後一項，以下都是 admin 設定：也可以寫在 .env 中，且 .env 的值優先於 /admin（見設定）。

設定	在 `/admin` 中
`BALNANA_BILLING_ENABLED`	方案與限制	設為 `true` 開啟方案。需要 `BALNANA_AUTH_MODE=accounts`。
`BALNANA_KOFI_URL`	Ko-fi 頁面	`https://` 網址。需與權杖一起設定。
`BALNANA_KOFI_TOKEN`	Ko-fi 驗證權杖
`BALNANA_PAYPAL_CLIENT_ID`	PayPal 用戶端 ID	來自 developer.paypal.com 的 REST 應用程式。需與密鑰、webhook ID 一起設定。
`BALNANA_PAYPAL_SECRET`	PayPal 密鑰
`BALNANA_PAYPAL_WEBHOOK_ID`	PayPal Webhook ID
`BALNANA_PAYPAL_SANDBOX`	PayPal 沙盒	設為 `true` 時使用 PayPal 沙盒，並搭配沙盒應用程式的憑證。
`BALNANA_PLAY_PACKAGE`	Google Play 套件名稱
`BALNANA_PLAY_SERVICE_ACCOUNT`	Google Play 服務帳號	服務帳號的 JSON 金鑰。
`BALNANA_PLAY_PUSH_ACCOUNT`	Pub/Sub 推送帳號
`BALNANA_PAYMENT_KEEP_DAYS`	—	只能寫在 `.env`。見付款紀錄。