2. Install & first run
Step 1 — Install from the Shopify App Store
Open the listing and click Install. Shopify walks you through the standard authorization flow. The app requests:
| Scope | Why it's needed |
|---|---|
read_orders |
Read order status/amount so the correct QR and reference can be generated |
write_orders |
Record whether an order's QR should currently show, hide, or is permanently settled |
write_app_proxy |
Serve the QR image used in order confirmation emails |
Step 2 — Land on the Home dashboard
After install you land on the app's Home page. A setup guide walks you through the two things every store needs before customers see a QR: an IBAN, and the checkout block. See Section 3.
What happens automatically
- A per-shop session is stored, using Shopify's expiring offline access tokens
- Compliance webhooks are registered (
customers/data_request,customers/redact,shop/redact) along withapp/uninstalled,app/scopes_update, and the order lifecycle topicsorders/create,orders/paid,orders/cancelled - Default settings are seeded (Thank you + Order status enabled, "manual" payment gating, hide-when-paid on)
Uninstalling
Shopify admin → Settings → Apps and sales channels → SEPA QR Payment →
Uninstall. The app/uninstalled webhook then removes your shop's stored
settings, bank accounts, and payment-tracking records.