Worlds / Payments and billing / Square
Square world
A local Square seller with locations, payments, orders, catalog items and Terminal checkouts. Test the agent that refunds in-person sales, fixes catalog prices and works within refund windows.
PaymentsRefundsOrdersCatalogTerminal
| Time | Items | Total | Status |
|---|---|---|---|
| 9:14 AM | Oat latte, croissant | $11.25 | Completed |
| 9:31 AM | Cold brew x2 | $9.50 | CompletedRefunded $4.75 |
| 10:02 AM | Beans 12oz | $18.00 | CompletedRefunded $18.00 |
| 10:40 AM | Catering box | $142.00 | CompletedRefunded $142.00 |
| 11:05 AM | Drip coffee | $3.25 | Completed |
fig. 1 · illustrative replica · the agent's changes land as you scroll
What's in this world
What you get when you open Square. Seeded, local, yours to break.
Seeded records
- locations
- 3 stores with their own devices
- payments
- 300 COMPLETED, 6 CANCELED, 4 FAILED
- orders
- 300 with line items and tenders
- catalog
- 85 ITEM objects, 140 ITEM_VARIATION objects
- terminal checkouts
- 2 stuck IN_PROGRESS
Agent jobs you can test
- Refund a payment or part of an order
- Update item variation prices in the catalog
- Cancel a stuck Terminal checkout
What your agent can get wrong here
The reply sounds right. The record is what counts.
ActionWhat the world recordsCommon mistake
Partial refund
refund amount_money against the order line itemRefunds the whole catering order for one missing trayChange a price
ITEM_VARIATION price_money at the right locationChanges the price at all three locations instead of oneCancel a checkout
terminal checkout status and device_idCancels a checkout on the wrong device mid-saleRefund an old sale
payment created_at against the refund windowTries a card refund past the window instead of a cash refundExample test
Describe the job. Review the checks before anything runs.
A catering customer was missing one $28 tray. Refund only that tray on the 10:40 order. Raise the oat latte price to $6.25 at Mission St only.
- 01Refund on the 10:40 order is $28.00
- 02No other refunds on the catering order
- 03Oat latte variation price $6.25 at Mission St
- 04Oat latte price unchanged at the other two locations
- 05No Terminal checkout canceled on device MS-02
fig. 2 · illustrative brief and drafted checks
Failures you can inject
Make it a bad day on purpose.
effect
A refund with a reused idempotency_key and new amount is rejectedfires before the handler · state untouched · same result every runEvidence
StatusIncluded in the closed beta, like every world in the catalog. Apply and tell us the workflow you want to test.Known limitations
