📡 Expected API — COOCO calls RideNDine
The list of API endpoints COOCO will call on RideNDine per phase. All paths below are COOCO's proposals — RideNDine needs to confirm or provide the correct paths.
All requests from COOCO go through the Directus Extension on the backend — never called directly from the browser/client.
📋 Endpoint List
| Phase | Method | Path | Trigger / Use Case | Status | Notes |
|---|---|---|---|---|---|
| Phase 1 | POST | /merchants/sync | Chef approved + store ready | ⏳ PENDING | Confirm path or provide correct endpoint |
| Phase 2 | POST | /checkout/quote | Customer checkout — before displaying total | ⏳ PENDING | Confirm path or provide correct endpoint |
| Phase 3 | POST | /orders/create | Customer confirms order | ⏳ PENDING | Confirm path or provide correct endpoint |
| Phase 4 | POST | /payment/process | Initiate payment | ⏳ PENDING | Confirm path or provide correct endpoint |
| Phase 5 | PATCH | /orders/status | Chef updates preparation status | ⏳ PENDING | Confirm path or provide correct endpoint |
| Phase 8 | GET | /orders/{id}/ledger | Admin financial reconciliation | ⏳ PENDING | Optional if ledger webhook is configured |
| Phase 9 | GET | /payouts/preview?chefId={id} | Chef views payout preview | ⏳ PENDING | Confirm path or provide correct endpoint |
| Phase 10 | POST | /refunds/create | Request a refund | ⏳ PENDING | Confirm path or provide correct endpoint |
📝 Endpoint Details
POST /merchants/sync — Phase 1
Synchronize merchant information from COOCO to RideNDine when a chef is approved and the store is ready.
Header: Idempotency-Key: merchant_sync_{store_id}
POST /checkout/quote — Phase 2
Fetch a quote from RideNDine (delivery fee, service fee, tax, tip) before displaying the total to the customer.
POST /orders/create — Phase 3
Create an order on RideNDine after the customer confirms checkout.
Header: Idempotency-Key: cooco_order_{orders.id}
POST /payment/process — Phase 4
Initiate a payment session — receive client_secret or checkout_url to embed the Stripe UI.
PATCH /orders/status — Phase 5
Update the chef's preparation status (PREPARING / READY / CANCELLED) so RideNDine can coordinate the driver.
GET /orders/{id}/ledger — Phase 8
Retrieve the financial breakdown of an order when an admin opens the details. Only used if the ledger webhook is not configured.
GET /payouts/preview?chefId={id} — Phase 9
View the list of upcoming payouts to be transferred to the chef.
POST /refunds/create — Phase 10
Submit a refund request for RideNDine to process via Stripe.