---
title: "Cegid Retail Mobile POS and Live Store"
description: "Learn more about using Tap to Pay on iPhone and Pay by Link using Cegid Retail Mobile POS and Live Store."
url: "https://docs.adyen.com/plugins/cegid-retail-y2/mobile-pos-and-live-store"
source_url: "https://docs.adyen.com/plugins/cegid-retail-y2/mobile-pos-and-live-store.md"
canonical: "https://docs.adyen.com/plugins/cegid-retail-y2/mobile-pos-and-live-store"
last_modified: "2024-07-05T10:16:00+02:00"
language: "en"
---

# Cegid Retail Mobile POS and Live Store

Learn more about using Tap to Pay on iPhone and Pay by Link using Cegid Retail Mobile POS and Live Store.

[View source](/plugins/cegid-retail-y2/mobile-pos-and-live-store.md)

After you set up a CPOS integration, you can set up [Cegid Retail Mobile POS](https://retail-docs.cegid.cloud/en/Y2/Mobile%20POS/Reference%20Product%20Documentation/Mobile%20POS%20V5/Accueil_MPOS_V5.htm) and [Cegid Retail Live Store](https://retail-docs.cegid.cloud/en/Y2/Cegid%20Retail%20Live%20Store/Reference%20Product%20Documentation/Cegid%20Retail%20Live%20Store/Sommaire.htm) integrations for iOS and Android devices.

These integrations require a Cegid Retail Y2 InStoreHub installed on a Windows device. InStoreHub requires Cegid Retail Y2 version 18 or later. The CPOS plugin has to be installed on the InStoreHub to allow communication between Cegid Retail Mobile POS/Live Store and Adyen terminals. Reach out to your Cegid contact if you need assistance with the setup.

![](/user/pages/docs/05.plugins/14.cegid-retail-y2/03.mobile-pos-and-live-store/extensions.svg?decoding=auto\&fetchpriority=auto)

### Cegid Retail Mobile POS

Cegid Retail Mobile POS is a mobile app for iOS devices. With this app, you can use the following Adyen solutions:

* [Tap to Pay on iPhone](#tap-to-pay-on-iphone)
* [Pay by Link](#pay-by-link)

### Cegid Retail Live Store

Cegid Retail Live Store is a progressive web app that you can run on any web browsing device. With this app, you can use Adyen's [Pay by Link](#pay-by-link) solution.

## Tap to Pay on iPhone

With a Cegid Retail Y2 Mobile POS integration, you can use our [Tap to Pay on iPhone](/point-of-sale/mobile-ios/build/tap-to-pay) solution to initiate and accept payments on an iPhone. This enables your store employees to assist shoppers with their payments anywhere in your store, without having your shoppers go to the cash register to complete their purchase.

To see a demo of the Tap to Pay on iPhone solution, get in touch with your Adyen contact.

### Requirements

The following requirements apply to use Tap to Pay on iPhone:

* Cegid Retail Y2 Mobile POS version 5.1.766 or later
* Cegid Retail Y2 version 18 or later
* [Hardware requirements](/point-of-sale/mobile-ios/requirements#hardware) for the iPhone
* [Software requirements](/point-of-sale/mobile-ios/requirements#software) for the iOS version that the iPhone must be on

If you do not have InStoreHub, you cannot print payment receipts. Check fiscal requirements per country/region and reach out to your Cegid contact to learn whether it is possible to launch Tap to Pay on iPhone without InStoreHub.

### How it works

1. In the Cegid Retail Y2 Mobile POS app on the iPhone, your store employee selects the option to pay with Tap to Pay on iPhone.
2. The iPhone shows a payment screen.
3. The shopper taps their card on the store employee's iPhone, or with their own device that has an NFC digital wallet to pay.
4. Your store employee receives the payment result in the Cegid Retail Mobile POS app.

### Set up Tap to Pay on iPhone

1. Get in touch with your Cegid contact to learn more about activating the extension for your Cegid Retail account.\
   Activating the extension comes with additional costs.
2. Get in touch with your Adyen contact to enable Tap to Pay on iPhone for your account.
3. Use the [Cegid documentation](https://retail-docs.cegid.cloud/en/Y2/Mobile%20POS/Reference%20Product%20Documentation/Mobile%20POS%20V5/Accueil_MPOS_V5.htm) to set up Tap to Pay on iPhone.

To test your Tap to Pay on iPhone integration, you must use a mobile device in Developer Mode.

### Troubleshooting Tap to Pay on iPhone

If you are experiencing an issue with the Tap to Pay on iPhone solution, first check the [Cegid documentation](https://retail-docs.cegid.cloud/en/Y2/Mobile%20POS/Reference%20Product%20Documentation/Mobile%20POS%20V5/Accueil_MPOS_V5.htm) to ensure that MPOS is correctly configured.

The following are the most common Tap to Pay on iPhone errors:

**

#### 403 error

**Cause 1**\
The 403 error is generally a misconfigured Cegid variable.

**Solution 1**

* Confirm that you have specified `POSSDKY2ConnectorUrl` as: **https\://retail-connectors.cegid.cloud/t/paybylink/api/AdyenPosSdkSession**
* Confirm that you have specified `POSSDKApiKey` with the correct Adyen webservice or user API key.

**Cause 2**\
The Adyen API key is structured incorrectly. You receive a 403 error if the API key contains:

* any of the characters: `< > ^`
* a string that can be identified as a word.

**Solution 2**\
Generate a new API Key.

**Example 403 error**

```bash
[15:10:46.918][9517][ERROR ] [ADYEN SDKV2] OpenSDKSession error : (Error Domain=com.alamofire.error.serialization.response Code=-1011 "Request failed: forbidden (403)" UserInfo={NSLocalizedDescription=Request failed: forbidden (403)
```

**

#### 903 error

**Cause**\
The 903 error is a generic error message that can refer to several issues.

**Solutions**

* Confirm that you have configured a Client Key for the webservice user in your [Customer Area](https://ca-test.adyen.com/).
* Confirm that you have configured payment methods in your merchant account.

**Example 903 error**

```json
{
  "SaleToPOIResponse": {
    "MessageHeader": {
      "MessageCategory": "Payment",
      "MessageClass": "Service",
      "MessageType": "Response",
      "POIID": "23F4BD3A-D123-4950-A91B-9916161DBA51.461",
      "ProtocolVersion": "3.0",
      "SaleID": "MTSTUS",
      "ServiceID": "161537"
    },
    "PaymentResponse": {
      "POIData": {
        "POITransactionID": {
          "TimeStamp": "2023-11-16T14:53:38.716Z",
          "TransactionID": "67C5876D-77FB-470F-AC25-9DAAD9B99919"
        }
      },
      "Response": {
        "AdditionalResponse": "message=An%20internal%20error%20occurred%20with%20error%20code%3A%20903&traceparent=00-727fd6b7c31f9aaef8d1244781f748f4-befde7407263ff1a-01",
        "ErrorCondition": "UnavailableService",
        "Result": "Failure"
      },
      "SaleData": {
        "SaleTransactionID": {
          "TimeStamp": "2023-11-16T14:53:37.753Z",
          "TransactionID": "9618E502-FF84-4009-BFEC-13E7CFDD1441"
        }
      }
    }
  }
}
```

**

#### Transaction always posts to merchant account rather than store

**Cause 1**\
There is no `storeID` configured.

**Solution 1**

1. Update to the latest version of MPOS.
2. Configure a `storeID` on the Cegid NewPosSettings page.

**Cause 2**\
You changed a `/sessions` configuration. For example, by changing the store or `merchantAccount` on the Cegid *NewPosSettings* page.

**Solution 2**\
Changes to the session take effect when a new session is established, normally 24 hours after establishing the original session. Cegid does not currently support a method to manually reset the function.

## Pay by Link

With a Cegid Retail Y2 Mobile POS/Live Store integration, you can use Adyen's [Pay by Link](/unified-commerce/pay-by-link) solution to create payment links for your shopper and allow them to pay in your physical store.

Payment links enable your shoppers to use payment methods that are not available on your payment terminal, like online banking or buy now pay later payment methods. This is useful, for example, in scenarios where the shopper forgot their credit card or does not have enough balance or limit on their card.

See the supported payment methods in the [Pay by Link documentation](/unified-commerce/pay-by-link/supported-payment-methods).

### Requirements

The following software and hardware requirements apply to use Pay by Link:

* Cegid Retail Y2 version 18 or later
* Cegid Retail Y2 Mobile POS 5.1.607 or later
* An Android or iOS Mobile device
* An Adyen payment terminal

### How it works

1. In the Cegid Retail Mobile POS or Live Store app on the Android or iOS device, your store employee selects the option to pay with Pay by Link.

2. Your shopper navigates to the payment link by either:

   * Scanning the QR code on the store's Android or iOS device with their personal device.
   * Opening the payment link they received as a text.

3. The shopper completes the payment on a secure Adyen payment page with their preferred payment method.

4. Your store employee receives the payment result in the Cegid Retail Mobile POS or Live Store app.

### Set up Pay by link

### Tab: With Mobile POS

1. Get in touch with your Cegid contact to learn more about activating the extension for your Cegid Retail account.
2. Use the [Cegid documentation](https://retail-docs.cegid.cloud/en/Y2/Mobile%20POS/Reference%20Product%20Documentation/Mobile%20POS%20V5/Accueil_MPOS_V5.htm) to set up the extension.
3. Inform your shoppers of the terms and conditions that apply to their purchase with Pay by Link by adding your terms and conditions to the Adyen-hosted payment page.\
   Refer to the [requirements for terms and conditions for Pay by Link](/unified-commerce/pay-by-link#terms-and-conditions-requirements) to learn about the information you have to include on the payment page.

### Tab: With Live Store

If you want to enable Pay by Link with Cegid Retail Y2 Live Store, reach out to your Cegid contact.
