> For the complete documentation index, see [llms.txt](https://developer.smarts.ee/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.smarts.ee/integration/custom-integration/home-delivery.md).

# Home delivery

{% hint style="info" %}
Implementation is **OPTIONAL**
{% endhint %}

### General flow

Client flow

* add products into shopping cart
* choose delivery method and time
* authorize the payment

Merchant flow

* confirm or reject order
* process order and update order status

{% hint style="warning" %}
**The payment will be settled after merchant has been sent out the order !** This process is needed because merchant may not be able to fully fill the order due the out of stock products.
{% endhint %}

{% hint style="info" %}
The authorized payment **will be release** when merchant reject the order or authorization will be expired. Authorization expiration time is set by the card network.
{% endhint %}

### Configuration

**Configure home delivery via Smarts manager UI.**  Smarts supports 3 delivery methods: **courier, parcel, pickup by myself.** Home delivery can be fully customized. You can set delivery price, reaction time for each store, availability time and dates, location and much more.

**Implement required endpoints for home delivery**

{% hint style="info" %}
**Smarts Worker App can be used also to manage home delivery orders** 
{% endhint %}

### Implementation

Create following endpoints

[**Receive order endpoint**](/integration/custom-integration/home-delivery/receive-order-endpoint.md)

[**Receive order update endpoint**](/integration/custom-integration/home-delivery/receive-order-update-endpoint.md)

Create following services to send and request order information from Smarts.

[**Update order status**](/integration/custom-integration/home-delivery/update-order-status.md)

[**Find order by id**](/integration/custom-integration/home-delivery/find-order-by-id.md)

[**Find order by invoice id**](/integration/custom-integration/home-delivery/find-order-by-invoice-id.md)

[**Find order by institution invoice id**](/integration/custom-integration/home-delivery/find-order-by-institution-invoice-id.md)