Overview
Keys order_default_deposit_mode and order_default_deposit_value in General Settings drive defaults across core, website public API, applets, and new orders. Website deposits endpoint applies breeder rules when buyers pay online.
Steps
- Set mode fixed or percent in General Settings.
- Test website deposit on a staging youngling before launch.
- Verify POS and kiosk show same default on new cart.
- Document exceptions in order notes when you override manually.
Practical note
Changing deposit defaults mid-season confuses buyers—communicate proactively.
Admin setup
General Settings keys drive core, website, applets. Gateway in Payment Gateways.
Advanced options
Website public deposit API reads breeder settings without exposing secrets. Per-litter overrides may exist on youngling or order—document in notes.
Troubleshooting
Buyer charged wrong amount: compare general settings, order line deposit override, and gateway receipt timestamp.
Developer & API notes (members)
Settings chain:
/api/v01/core/general_settings/fetch.php— includes deposit keys/api/v01/core/deposit_settings/fetch.php— normalized deposit DTO for app/api/v01/website/public/deposit_settings/fetch.php— public website
Applets read the same core deposit settings when creating orders. Changing General Settings affects new carts—not always historical orders.