FleetbaseFleetbase
Start Free Trial

Orders

Storefront order endpoints expose customer-facing actions after checkout. Use them to mark pickup orders complete and retrieve receipts for supported payment methods.

The Storefront Order object

A storefront order is a FleetOps order created from a captured storefront checkout.
Attributes
idstringoptional

Public identifier of the order.

public_idstringoptional

Public identifier of the order.

statusstringoptional

Order lifecycle status.

typestringoptional

Order type, usually storefront for orders created by this API.

payloadobjectoptional

FleetOps payload created from the storefront cart.

customerobjectoptional

Customer associated with the order.

metaobjectoptional

Storefront checkout, payment, totals, and fulfillment metadata.

notesstringoptional

Order notes supplied during checkout capture.

created_attimestampoptional

Time the order was created.

updated_attimestampoptional

Time the order was last updated.

The Storefront Order object
{
  "id": "order_9Kx2mQ1",
  "public_id": "order_9Kx2mQ1",
  "status": "created",
  "type": "storefront",
  "payload": null,
  "customer": null,
  "meta": {
    "checkout_id": "checkout_123",
    "storefront": "Acme Market",
    "total": 5150,
    "currency": "USD"
  },
  "notes": null,
  "created_at": "2026-05-07T09:30:00Z",
  "updated_at": "2026-05-07T09:30:00Z"
}
PUT/v1/orders/picked-up

Complete Order Pickup

Marks an authenticated customer's pickup order as completed. Fleetbase verifies that the order belongs to the customer before updating the order status.

Body parameters
orderstringrequired

Public ID of the pickup order to mark completed.

PUT/v1/orders/picked-up
curl -X PUT https://api.fleetbase.io/v1/orders/picked-up \
  -H "Authorization: Bearer flb_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "order": "{{order_id}}"
}'
POST/v1/orders/receipt

Get Order Receipt

Returns a receipt for an authenticated customer's order when the payment method supports receipts. QPay orders can generate an Ebarimt receipt.

Body parameters
orderstringrequired

Public ID of the order to retrieve a receipt for.

ebarimt_receiver_typeenumoptional

Ebarimt receiver type for QPay receipts. One of CITIZEN, COMPANY.

ebarimt_receiverstringoptional

Company registration number. Required when ebarimt_receiver_type is COMPANY.

POST/v1/orders/receipt
curl -X POST https://api.fleetbase.io/v1/orders/receipt \
  -H "Authorization: Bearer flb_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "order": "{{order_id}}",
  "ebarimt_receiver_type": "CITIZEN",
  "ebarimt_receiver": ""
}'
Orders | Fleetbase