Square Product Data and Receipt Roller Product Data Mapping
Explains how product data in Square Catalog is converted into Receipt Roller's product master (ProductDto), field by field. Covers the relationship between Item / Variation / Category, price currency normalization, and behavior on re-sync.
Pairing an Android Device
Step-by-step guide to pairing an Android device installed in your store with your Receipt Roller business account for Media Display. A 6-digit code registration flow that takes about a minute per device.
How Customers Receive Receipts
Explains the flow from a customer scanning a QR code to receiving their e-receipt, screen by screen.
Square Customer Data and Receipt Roller Customer Data Mapping
Explains how customers registered in Square Customer Directory are converted into Receipt Roller's customer data (CrmCustomerDto), field by field. Covers the given_name / family_name correspondence, address decomposition logic, and how reference_id is handled.
How Automatic Delivery (LINE / App / Email) Works
Explains how receipts are automatically delivered when a ReceiptRoller member checks out, and the priority order used to choose the delivery destination.
Smaregi Product Data and Receipt Roller Product Data Mapping
Explains how Smaregi's product master is converted into Receipt Roller's product master (ProductDto), field by field. Covers the correspondence for product code, product name, category, price, and cost, along with quirks specific to Smaregi.
Smaregi Staff Data and Receipt Roller Staff Data Mapping
Explains how Smaregi staff master data is converted into Receipt Roller's staff data (StaffDto), field by field. Covers the name-splitting logic for staffName, the staffCode to EmployeeNumber mapping, and how displayFlag controls skipping of hidden staff.
Issuing and Disabling Transaction QR Codes
Explains how to use the "transaction QR," which staff can issue individually for a specific past transaction, and how to disable it if issued in error.
Connecting with POS
An overview of the POS systems that can connect with ReceiptRoller and how to connect them. Supports Square and Smaregi.
Receipt Handling for Refunds and Cancellations
Explains how e-receipts are handled when a customer requests a refund after checkout, or a mis-entered sale is voided. Covers what customers see and how staff should operate.
Printing the Receipt QR Sticker
Explains how to print the PDF for the QR code sticker attached to each register, and points to keep in mind when printing and applying it.
Square Staff Data and Receipt Roller Staff Data Mapping
Explains how Square Team Members are linked to Receipt Roller's staff data (StaffDto). Covers how to use manual linking, the logic for resolving who is attributed to a transaction, and the key fields in the Team Member API.
Store Status Management
Explains how to check and change a store's operating status (Open, Temporarily Closed, Closed), and the impact a status change has on each feature.
Mapping a Custom Domain and Verifying DNS
You can publish your store app's web channel under your own custom domain (e.g. app.your-store.com). This article covers how to add a domain, set up DNS records, the verification flow, automatic SSL certificate issuance, the difference between subdomains and root domains, and common troubleshooting.
Membership Card Design Editor (Colors by Rank, Logo, Live Preview)
The Wallet membership card design editor in the store admin screen lets you edit the background color, logo, and text color per rank while watching a live preview. This article covers how to use the editor, per-rank design management, recommended image specs, and how changes are reflected on existing cards after publishing.
Closing a Business Account
Steps for closing a business account and what gets deleted — stores, products, customers, staff, transaction history, POS integrations, and more. Also covers how Stripe subscriptions are handled and who this affects. This action cannot be undone.
Registering Product Information
Steps for registering a new product. Explains basic information, pricing, specifications, B2B/logistics information, variations, and store-specific pricing, with screenshots.