> Note:
> This is a legacy API. Use the latest version of [`POS`](/docs/api/app-bridge-library/apis/pos) instead.

Provides a mechanism for closing the app when it's running in Shopify POS, and for retrieving information about a Shopify POS device.

## Requirements

- User and location data are available in all version of Point of Sale Android and iOS.
- Device data is available in following app version:
  * **Point of Sale iOS version 5.36.0** or above
  * **Point of Sale Android version 3.29.0** or above
- Close is available in the following app version:
  * **App Bridge version 1.18.0** or above is required
  * **Point of Sale iOS version 5.50.0** or above
  * **Point of Sale Android version 3.43.0** or above

## Setup

Create an app and import the `Pos` module from `@shopify/app-bridge/actions`. Note that we'll be referring to this sample application throughout the examples below.

> Note
> In the following example, `config` is a valid App Bridge configuration object. Learn more about [configuring App Bridge](/docs/api/app-bridge/previous-versions/app-bridge-from-npm/app-setup#initialize-shopify-app-bridge-in-your-app).


```js
import createApp from '@shopify/app-bridge';
import {Pos} from '@shopify/app-bridge/actions';

const app = createApp(config);
```

## Close an app embedded in Shopify POS

Create a Pos object that can be used to close the embedded app. You might close the embedded app after the user successfully completes an action to return them to the Shopify POS app.

```js
const pos = Pos.create(app);
```

To close the embedded app, use the Pos object to dispatch the `CLOSE` action.

```js
// App Bridge 1.x
pos.dispatch(Pos.ActionType.CLOSE);

// App Bridge 2.x
pos.dispatch(Pos.Action.CLOSE);
```

## Get POS data

POS data is available in the state and accessible through [app.getState()](/docs/api/app-bridge/previous-versions/methods#app-getstate). There are several ways to get the data:

**Option 1: get all state**

```js
app.getState().then((data) => {
  const {pos} = data;
});
```

**Option 2: get only pos**

```js
app.getState('pos').then((pos) => {
});
```

**Option 3: get only pos user**

```js
app.getState('pos.user').then((user) => {
});
```

**Option 4: get only pos location**

```js
app.getState('pos.location').then((location) => {
});
```

**Option 5: get only pos device**

```js
app.getState('pos.device').then((device) => {
});
```

> Note
> app.getState() just returns current state. To avoid getting state before it is ready, you may need to subscribe as below:
>
> ```js
> const unsubscribe = app.subscribe(function() {
>   app.getState('pos').then(function(pos) {
>     if (!pos) {
>       return;
>     }
>     unsubscribe();
>   });
> });
> ```

## Payload


### POS Payload

<table>
  <thead>
    <tr>
      <th>Key</th>
      <th>Type</th>
      <th>Description</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>user</code></td>
      <td><a href="#user-payload">User</a></td>
      <td>User info.</td>
    </tr>
    <tr>
      <td><code>location</code></td>
      <td><a href="#location-payload">Location</a></td>
      <td>Location info.</td>
    </tr>
    <tr>
      <td><code>device</code></td>
      <td><a href="#device-payload">Device</a></td>
      <td>Device info.</td>
    </tr>
  </tbody>
</table>

### User Payload

<table>
  <thead>
    <tr>
      <th>Key</th>
      <th>Type</th>
      <th>Description</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>id</code></td>
      <td>Number</td>
      <td>The ID of login user.</td>
    </tr>
    <tr>
      <td><code>firstName</code></td>
      <td>String</td>
      <td>The first name of login user.</td>
    </tr>
    <tr>
      <td><code>lastName</code></td>
      <td>String</td>
      <td>The last name of login user.</td>
    </tr>
    <tr>
      <td><code>email</code></td>
      <td>String</td>
      <td>The email name of login user.</td>
    </tr>
    <tr>
      <td><code>accountOwner</code></td>
      <td>Boolean</td>
      <td>Indicate if login user is the shop owner.</td>
    </tr>
    <tr>
      <td><code>userType</code></td>
      <td>String</td>
      <td>The type of login user.</td>
    </tr>
  </tbody>
</table>

### Location Payload

<table>
  <thead>
    <tr>
      <th>Key</th>
      <th>Type</th>
      <th>Description</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>id</code></td>
      <td>Number</td>
      <td>The ID of current location.</td>
    </tr>
    <tr>
      <td><code>active</code></td>
      <td>Boolean</td>
      <td>The status of current location.</td>
    </tr>
    <tr>
      <td><code>name</code></td>
      <td>String</td>
      <td>The name of current location.</td>
    </tr>
    <tr>
      <td><code>locationType</code></td>
      <td>String?</td>
      <td>The type of current location.</td>
    </tr>
    <tr>
      <td><code>address1</code></td>
      <td>String?</td>
      <td>The primary address of current location.</td>
    </tr>
    <tr>
      <td><code>address2</code></td>
      <td>String?</td>
      <td>Any extra information associated with the address (Apartment #, Suite #, Unit #, etc.).</td>
    </tr>
    <tr>
      <td><code>zip</code></td>
      <td>String?</td>
      <td>The ZIP or postal code of the address.</td>
    </tr>
    <tr>
      <td><code>city</code></td>
      <td>String?</td>
      <td>The name of the city.</td>
    </tr>
    <tr>
      <td><code>province</code></td>
      <td>String?</td>
      <td>The province or state of the address.</td>
    </tr>
    <tr>
      <td><code>countryCode</code></td>
      <td>String?</td>
      <td>The Country Code in ISO 3166-1 (alpha-2) format.</td>
    </tr>
    <tr>
      <td><code>countryName</code></td>
      <td>String?</td>
      <td>The country of the address.</td>
    </tr>
    <tr>
      <td><code>phone</code></td>
      <td>String?</td>
      <td>The phone number of the location.</td>
    </tr>
  </tbody>
</table>

### Device Payload

<table>
  <thead>
    <tr>
      <th>Key</th>
      <th>Type</th>
      <th>Description</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>name</code></td>
      <td>String</td>
      <td>The name of the device</td>
    </tr>
    <tr>
      <td><code>serialNumber</code></td>
      <td>String</td>
      <td>The unique ID associated device ID and app ID.</td>
    </tr>
  </tbody>
</table>