> ## Documentation Index
> Fetch the complete documentation index at: https://help.atlas.kitchen/llms.txt
> Use this file to discover all available pages before exploring further.

# Accept ShopBack payments

> Let customers pay with the ShopBack app at your POS and kiosk. They scan a QR code on your Atlas Pay terminal and earn cashback.

<Info>
  **Who is this article for?**

  Restaurant operators who want to accept ShopBack payments on Atlas POS and Atlas Kiosk.
</Info>

## What this does

ShopBack is a cashback and rewards app. Customers pay through the app using a linked card or wallet, and earn cashback at your store.

With this integration, ShopBack appears as a payment type on your Atlas POS and Kiosk. When ShopBack is selected at checkout, a QR code appears on your Atlas Pay terminal. The customer scans the code with the ShopBack app and pays. Atlas marks the order as paid automatically.

## Before you start

<Info>
  Enabling the payment type is only half the setup. The Atlas team must also connect your account to ShopBack. Until both are done, ShopBack is greyed out on the POS and does not show on the kiosk.
</Info>

<Info>
  ShopBack needs an Atlas Pay terminal, because the QR code is shown on the terminal screen. Stations without a terminal cannot take ShopBack payments.
</Info>

## Turn on ShopBack

Two things must happen before ShopBack works at checkout. You enable the payment type, and the Atlas team completes your account setup.

<Steps>
  <Step title="Go to Payment types">
    In the merchant portal, go to **Settings** > **Payment types**.
  </Step>

  <Step title="Enable ShopBack">
    In the **Terminal payment types** section, switch the **Enabled** toggle on next to **ShopBack**.

    <Frame caption="The ShopBack toggle under Terminal payment types">
      <img width="700" src="https://mintcdn.com/atlaskitchen/Yr1PHgZke07iZpve/images/integrations/shopback-terminal-payment-types.png?fit=max&auto=format&n=Yr1PHgZke07iZpve&q=85&s=445f13113055cb25085b55f80e492617" alt="Terminal payment types list in the merchant portal with the ShopBack row highlighted and its Enabled toggle switched on" data-path="images/integrations/shopback-terminal-payment-types.png" />
    </Frame>
  </Step>

  <Step title="Contact Atlas to complete the setup">
    Email your account manager or [hello@atlas.kitchen](mailto:hello@atlas.kitchen). The Atlas team connects your account to ShopBack and confirms when it is live.
  </Step>
</Steps>

Once the Atlas team confirms, ShopBack appears in the payment method selection on your POS and Kiosk.

## Taking a ShopBack payment

<Steps>
  <Step title="Charge the order">
    Take the order as usual. Tap **Charge**, then select **ShopBack** as the payment method.

    On the kiosk, the customer selects **ShopBack** on the payment screen themselves.
  </Step>

  <Step title="Ask the customer to scan the QR code">
    A QR code appears on the Atlas Pay terminal. It does not appear on the POS or kiosk screen.

    The customer scans the code with the ShopBack app and confirms the payment in the app.
  </Step>

  <Step title="The terminal shows Approved">
    After the customer pays, the terminal takes a couple of seconds to show **Approved**. Atlas then marks the order as paid. Print receipts and fire the order as usual.
  </Step>
</Steps>

## What should happen

* The QR code appears on the terminal within a few seconds of selecting ShopBack.
* The terminal shows **Approved** a couple of seconds after the customer pays in the app.
* The order is marked as paid in Atlas.
* The customer sees a payment confirmation and their cashback in the ShopBack app.

<Frame caption="A successful payment in the customer's ShopBack app">
  <img width="300" src="https://mintcdn.com/atlaskitchen/Yr1PHgZke07iZpve/images/integrations/shopback-app-payment-details.png?fit=max&auto=format&n=Yr1PHgZke07iZpve&q=85&s=4263b6f6a987d22d027ba3627bc4cb89" alt="ShopBack app Payment details screen showing a successful 7.50 payment with a green tick, the Order ID, date and time, store name, cashback earned, and payment summary" data-path="images/integrations/shopback-app-payment-details.png" />
</Frame>

## Good to know

* **Payment limits**: ShopBack accepts payments between \$0.10 and \$9,999. For totals outside this range, ShopBack cannot be selected at checkout.
* **Where it works**: ShopBack is available on Atlas POS and Kiosk only. It is not available on Atlas Online or Scan to Order.
* **Refunds**: Refund the order in Atlas as usual. The refund is triggered on ShopBack automatically. See [Issue refunds](/merchant-portal/refunds).
* **Payouts**: ShopBack pays you directly, under your ShopBack agreement. ShopBack payments are not included in your Atlas payouts, and Atlas does not deduct a payment processing fee on them.
* **ShopBack discounts and cashback**: These are handled inside the ShopBack app. They do not appear on the POS and do not change the order total in Atlas.

## Turn off ShopBack at one outlet

If some of your outlets take ShopBack and others do not, limit it per outlet.

<Info>
  If an outlet has no POS payment types selected, it uses all your globally enabled payment types, including ShopBack. To exclude ShopBack, you must select every payment type the outlet does accept.
</Info>

<Steps>
  <Step title="Edit the outlet">
    In the merchant portal, go to **Outlet settings** > **Outlets**. Click **Edit** next to the outlet, then find the **Payments** section.
  </Step>

  <Step title="Select every payment type except ShopBack">
    Under **POS payment types**, select all the payment types this outlet accepts, and leave ShopBack out.

    <Frame caption="Selecting every POS payment type except ShopBack for an outlet">
      <img width="700" src="https://mintcdn.com/atlaskitchen/Yr1PHgZke07iZpve/images/integrations/shopback-outlet-payment-types.png?fit=max&auto=format&n=Yr1PHgZke07iZpve&q=85&s=0109bbe19d984c33110898ccd23ee43a" alt="Outlet payments settings with Alipay, Cash, Credit Card, GrabPay and WeChat Pay selected under POS payment types, and ShopBack left unselected in the dropdown" data-path="images/integrations/shopback-outlet-payment-types.png" />
    </Frame>
  </Step>

  <Step title="Save the outlet">
    Click **Update outlet**. ShopBack no longer appears at checkout for this outlet.
  </Step>
</Steps>

## If it doesn't work

<AccordionGroup>
  <Accordion title="ShopBack is greyed out or missing at checkout">
    1. Check the order total. ShopBack cannot be selected below \$0.10 or above \$9,999.
    2. Check ShopBack is switched on under **Settings** > **Payment types**, in the **Terminal payment types** section.
    3. Check the outlet's **POS payment types** under **Outlet settings** > **Outlets**. If payment types are selected there, ShopBack must be one of them.
    4. Check the station has an Atlas Pay terminal.
    5. If ShopBack is still greyed out on the POS, or missing on the kiosk, the Atlas setup may not be complete. Contact support.
  </Accordion>

  <Accordion title="The terminal doesn't show Approved after the customer pays">
    1. Wait a few seconds. The terminal takes a moment to confirm the payment.
    2. Check your ShopBack merchant dashboard to verify whether the payment went through.
    3. Ask the customer to show the **Payment details** screen in their ShopBack app.
    4. If the payment went through but the order isn't marked as paid, follow the steps in the next section.
  </Accordion>

  <Accordion title="The QR code doesn't appear on the terminal">
    1. Check the terminal is switched on and connected.
    2. Cancel the payment and select **ShopBack** again.
    3. If the terminal is unresponsive, see [Terminal troubleshooting](/hardware/terminal-troubleshooting).
    4. Take another payment method in the meantime. Service is not blocked.
  </Accordion>

  <Accordion title="The customer paid in the app, but the order isn't marked as paid">
    The customer's ShopBack app is the source of truth for the payment.

    1. Ask the customer to open the payment in the ShopBack app and show the **Payment details** screen.
    2. Take a photo or screenshot of that screen.
    3. If a screenshot isn't possible, note down the ShopBack Order ID (e.g. 260819-5594-NLZU), the date and time, the amount, and the store name.
    4. Send this to support at [hello@atlas.kitchen](mailto:hello@atlas.kitchen) so the team can reconcile the payment.
  </Accordion>
</AccordionGroup>

If the issue persists, contact support at [hello@atlas.kitchen](mailto:hello@atlas.kitchen).

## What's next

* [Add or remove payment types](/merchant-portal/payment-methods)
* [Issue refunds](/merchant-portal/refunds)
* [Terminal troubleshooting](/hardware/terminal-troubleshooting)