SureCart ability reference
Reference for the GoBuildWP Pro 1.14.0 source. Installed schemas and policy remain authoritative.
This SureCart ability reference lists every call GoBuildWP Pro registers for SureCart, with the exact slug an agent sends and what the plugin's own contract says it does. Of the 7, 6 read, 0 write and 1 is marked destructive in the source.
Read-only, write and destructive groups describe the source annotations. They do not establish a minimum safety profile, human approval or undo support. Those controls are separate: check the installed ability, the connected user and the active site policy before calling it. A read can still return sensitive data. These pages are not evidence that every operation passed an end-to-end runtime test.
What SureCart needs before these load
These 7 abilities come with GoBuildWP Pro 1.14.0. Pro registration requires the Freemius SDK to permit premium code and any companion dependency the module checks to be available. The floors below apply to the named dependencies or features; an optional add-on or newer feature floor does not necessarily disable the base module. wppilot/integration-health and the module's setup call describe the installed availability.
- Minimum (base)
- 3.0.0
WPPILOT_PRO_SURECART_MIN_VERSION - Declared compatibility tags
- free, pro (source compatibility labels; these do not establish that the vendor sells a Free or Pro edition. Follow the prerequisites and installed-plugin checks below.)
- Agent skills shipped
surecart-integration
SureCart reads
| Ability | What it does |
|---|---|
wppilot/surecart-check-setupCheck SureCart Setup | Reports the SureCart version against GoBuildWP's floor, whether the store is connected to SureCart's API, the store name and currency, product/order/customer/coupon counts when connected, and which SureCart capabilities the current user holds. The API token is never read out. |
wppilot/surecart-get-productGet SureCart Product | Returns one SureCart product with its prices and variants. |
wppilot/surecart-list-couponsList SureCart Coupons | Lists SureCart coupons from SureCart's API with percent or amount off, duration, redemption limits and counts, expiry (redeem_by, Unix time) and archived state. Archived coupons are listed only with archived=true. |
wppilot/surecart-list-customersList SureCart Customers | Lists SureCart customers from SureCart's API with id, name, mode and signup time. Email addresses, phone numbers and addresses are never returned. |
wppilot/surecart-list-ordersList SureCart Orders | Lists SureCart orders from SureCart's API, newest first, with number, status, fulfillment and shipment status, live or test mode, and checkout totals in minor units. Filters by status and mode. Customer name, email, addresses and payment methods are never returned. Date ranges are not offered: SureCart's order list has no documented date filter. |
wppilot/surecart-list-productsList SureCart Products | Lists SureCart products from SureCart's API with status, stock and their prices (amount in minor units, currency, recurring interval). Archived products are listed only with archived=true. |
Destructive SureCart calls
| Ability | What it does |
|---|---|
wppilot/surecart-update-couponUpdate SureCart Coupon | Changes a SureCart coupon's name, percent off (percent coupons only), amount off (fixed coupons only, minor units), redemption limit, expiry date or archived state through SureCart's API. Promotion codes, products and duration are not touched. The change is made in SureCart's hosted store, so wppilot/rollback-change cannot undo it; every write needs confirm=true and the previous values are returned. |