# Storefront orders

Use these operations to access Storefront orders.

Storefront operations interact directly with the customer,
and provide the customer with access to their own data.

To use Storefront operations, the customer must be issued a JWT with limited permissions. For more information, see [Create a session with username and password](https://www.rebilly.com/catalog/all/storefront-account/storefrontpostlogin) and [Exchange an authentication token](https://www.rebilly.com/catalog/all/customer-authentication/postauthenticationtokenexchange).
Storefront operations are intended to be used directly from an untrusted browser.

## Retrieve an upcoming order invoice

 - [GET /storefront/orders/{id}/upcoming-invoice](https://www.rebilly.com/static/_spec/catalog/all-3.0/storefront-orders/storefrontgetorderupcominginvoice.md): Retrieves an upcoming invoice for a specified order.

An upcoming invoice is an invoice that has not been issued.
It functions as a preview of the next invoice for the order.
For more information, see Invoices.

## Retrieve orders

 - [GET /storefront/orders](https://www.rebilly.com/static/_spec/catalog/all-3.0/storefront-orders/storefrontgetordercollection.md): Retrieve a list of orders.

## Retrieve an order

 - [GET /storefront/orders/{id}](https://www.rebilly.com/static/_spec/catalog/all-3.0/storefront-orders/storefrontgetorder.md): Retrieve an order with a specified ID.

## Update an order

 - [PATCH /storefront/orders/{id}](https://www.rebilly.com/static/_spec/catalog/all-3.0/storefront-orders/storefrontpatchorder.md): Updates an order with a specified ID.

## Cancel an order

 - [POST /storefront/orders/{id}/cancellation](https://www.rebilly.com/static/_spec/catalog/all-3.0/storefront-orders/storefrontpostordercancellation.md): Cancels an order with a specified ID.

## Pause a subscription order

 - [POST /storefront/orders/{id}/pause](https://www.rebilly.com/static/_spec/catalog/all-3.0/storefront-orders/storefrontpostorderpause.md): Pauses an order with a specified ID.

## Change subscription items

 - [POST /storefront/subscriptions/{id}/change-items](https://www.rebilly.com/static/_spec/catalog/all-3.0/storefront-orders/storefrontpostsubscriptionitemschange.md): Creates a quote for requested changes to items and quantities.
This operation applies the requested changes to the subscription when the quote is accepted.

## Reactivate a subscription

 - [POST /storefront/subscription-reactivations](https://www.rebilly.com/static/_spec/catalog/all-3.0/storefront-orders/storefrontpostsubscriptionreactivation.md): Creates a quote for requested reactivation.
This operation applies the requested reactivation to the subscription when the quote invoice is paid.

## Create a subscription

 - [POST /storefront/subscriptions](https://www.rebilly.com/static/_spec/catalog/all-3.0/storefront-orders/storefrontpostsubscription.md): Creates a subscription order in a billing portal.