In-Store Integrations

Overview

The ShopBack In-Store Payments API lets you accept ShopBack Pay for in-store and point-of-sale (POS) payments.

That includes classic counter and terminal checkout and in-store / POS payments taken through a customer-facing app or customer-facing website (for example table ordering, order through app, browse-and-pay in store).

If the customer is paying at a physical location or on-premise station, and your system starts the payment, this is the right API — whether the UI is an app, a website, a kiosk, a cashier screen, or a payment terminal.

Who this is for

This API is for merchants and payment partners who want to accept in-store / POS ShopBack Pay on surfaces they already operate, including:

SurfaceWhat we meanIn-store / POS role
Customer-facing appShopper-facing mobile or tablet appTakes in-store or on-premise POS payment inside the merchant app
Customer-facing websiteShopper-facing web experienceTakes in-store or on-premise POS payment in the browser
KioskSelf-checkout or self-service orderingCustomer pays at the kiosk as the point of sale
CashierStaff-operated counter or registerStaff completes the in-store sale for the customer
Payment terminalPayment hardware or softPOSTerminal initiates or confirms the in-store payment

Customer-facing apps and websites are first-class in-store / POS surfaces for this API. Use them when the shopper pays through your digital experience for fulfilment in-store and promotions may take place at specific stores or outlets. When completing a remote online checkout, use the Online Bespoke Integration.

When to use In-Store vs Online

Use In-Store IntegrationsUse Online Bespoke Integration
In-store or point-of-sale payment at a physical location or on-premise stationRemote online checkout in a normal e-commerce journey
Payment started from a customer-facing app, customer-facing website, kiosk, cashier, or payment terminal and goods or services are provided in-storeGoods or services are delivered remotely to the customer

How payments work

ShopBack supports three methods for in-store / POS payment. You can offer one or more, depending on the surface.

MethodBest for
Merchant-presented QRApp, website, kiosk, cashier display, or terminal shows a QR
Customer-presented QRCashier, scanner, or terminal scans the customer’s ShopBack QR
URL redirectCustomer-facing apps and websites — customer is sent into ShopBack to pay, then returned to your app or site

Merchant-presented and customer-presented QR work across apps, websites, kiosks, cashier flows, and terminals. URL redirect is for customer-facing apps and websites used as the in-store / POS payment UI.

Merchant-presented QR

Your in-store / POS experience displays a ShopBack QR — including on a customer-facing app or website screen, or on a kiosk, cashier display, or terminal. The customer scans it with the ShopBack app and pays.

Best fit when the customer is looking at your screen at the point of sale (app, web, or hardware).

Customer-presented QR

The customer shows a ShopBack QR. Your cashier, scanner, terminal, or assisted in-store flow reads it and submits the payment.

Best fit when staff or a terminal scans the customer during an in-store / POS payment.

URL redirect (customer-facing apps and websites)

For in-store / POS payments through a customer-facing app or website, you can send the customer into ShopBack via a URL redirect to complete payment, then return them to your app or website when done.

Use this when your on-premise app or website should hand the customer to ShopBack’s payment experience (instead of only showing or scanning a QR on your screen).

Best fit for customer-facing apps and websites acting as the in-store / POS checkout UI — not for kiosk-only, cashier-scan, or payment-terminal hardware flows that rely on QR at the device.

Getting started

  1. Confirm you are accepting in-store / point-of-sale payments or payments via a customer-facing app or website where the goods or services are provided on premise and promotions are performed for specific stores
  2. Choose merchant-presented QR, customer-presented QR, or the URL redirect approach.
  3. Follow the Implementation guide for the integration and certification path.
  4. Use API Reference — Getting Started for credentials, base URLs, and endpoint details.

Next steps



Did this page help you?