Skip to main content
Crave supports four fulfillment methods. This guide covers how to set each one on a cart and what data each method requires.

​
Available methods

MethodValueUse case
Takeout / PickuptakeoutCustomer picks up at the counter
DeliverydeliveryOrder delivered to customer’s address
Table-sidetable_sideDine-in, delivered to a table number
Room serviceroom_serviceHotel/hospitality, delivered to a room

​
Check which methods are enabled

Each location has a methodsStatus field indicating what’s available. 
const merchant = await storefront.merchant.getBySlug('downtown-pizza');
const location = merchant.locations[0];

console.log(location.methodsStatus);
// { pickup: true, table: true, delivery: true, roomService: false }
Only show fulfillment options that are enabled for the location.

​
Takeout (default)

Takeout is the simplest method — just set the fulfillment method on the cart. 
await storefront.cart.update('loc_123', cartId, {
  fulfillmentMethod: 'takeout',
});

​
Delivery

Delivery requires the customer’s address with geographic coordinates for distance calculation and fee computation.
1

Check delivery distance

Calculate the distance between the customer and the location to validate the delivery zone.
2

Set delivery address

Save the address to the cart.

​
Check delivery distance

const distance = await storefront.locations.getDistance('loc_123', {
  lat: 37.7749,
  lng: -122.4194,
  unit: 'miles',
});

console.log(`${distance.distance.miles} miles away`);

​
Set delivery address

await storefront.cart.setDelivery('loc_123', cartId, {
  street: '123 Main Street',
  city: 'San Francisco',
  state: 'CA',
  zipCode: '94105',
  country: 'US',
  lat: 37.7749,
  lng: -122.4194,
});
The Address type requires these fields:
FieldTypeRequiredDescription
streetstringYesStreet address
streetOptionalstringNoApt/suite/floor
citystringYesCity
statestringYesState/province code
zipCodestringYesPostal code
countrystringYesCountry code (e.g., US, GB)
latnumberYesLatitude
lngnumberYesLongitude
Use a geocoding service (Google Places, Mapbox) to get lat/lng from the customer’s address input.

​
Table-side

Table-side service sends the order to a specific table number within the restaurant. 
await storefront.cart.setTable('loc_123', cartId, 'T-12');
Table numbers are freeform strings — use whatever format the restaurant uses (e.g., "12", "T-12", "Patio 3").

​
Room service

Room service is designed for hotels and hospitality venues. It requires a room number and the guest’s last name for verification. 
await storefront.cart.setRoom('loc_123', cartId, {
  roomNumber: '405',
  lastName: 'Johnson',
});

​
Fulfillment fees

Each fulfillment method may have associated fees configured by the restaurant. These are automatically calculated and included in the cart totals:
Cart fieldDescription
fulfillmentMethodFeeTotalThe fee for the selected fulfillment method
fulfillmentMethodFeeTotalFormattedFormatted version (e.g., "$3.99")
The fee breakdown is also available in cart.fees: 
const cart = await storefront.cart.get('loc_123', cartId);
console.log('Delivery fee:', cart.fulfillmentMethodFeeTotalFormatted);
console.log('Fee rate:', cart.fees.fulfillmentMethodFeeRate);
console.log('Fee fixed:', cart.fees.fulfillmentMethodFeeFix);

​
Next steps

Checkout Flow

Complete the order with customer details and payment.

Accept Payments

Set up Stripe for secure payment processing.