# StableFlowers API

StableFlowers sends real florist-delivered flowers through Florist One. Buyers pay the exact Florist One order total with x402 on Base. StableFlowers does not add a service fee.

Supported payment: x402 on Base mainnet only.

## Flow

1. GET /api/products — browse flower products by category or product code.
2. GET /api/delivery-dates — list available delivery dates for a recipient ZIP/postal code.
3. POST /api/quote — calculate the exact Florist One total for flower products.
4. POST /api/orders — pay the quoted total with x402 and place the order.
5. GET /api/orders/{orderId} — retrieve a stored order by local ID or Florist One order number with SIWX.

## Important Behavior

StableFlowers supports flower products only. Do not submit tree products with code TREES.

Order pricing is dynamic. Always call /api/quote before /api/orders, then submit the same products and delivery details to /api/orders. The paid order endpoint re-validates delivery availability and total before requesting payment.

Florist One handles customer service directly. Returned confirmations include their support contact:
- Phone: 888-610-8262
- Text: 501-406-0358
- Email: service@floristone.com

Florist One does not expose live delivery tracking or cancellation through the API. The order lookup endpoint returns the submitted order details, not live delivery status.

## Idempotency

POST /api/orders requires clientRequestId. Reuse the same clientRequestId only for retrying the same intended order. StableFlowers uses it to prevent duplicate Florist One order placement.

## Refund Credits

Florist One reports full and partial credits through a daily report. StableFlowers records these credits for manual customer refund handling.