Developer API Overview
Learn about the Receipt Roller developer API and the steps to get started. Available on Starter plan and above.
Where to Find the API Reference
The list of API endpoints and sample request/response formats are published in the Developer Help.
API Keys and Client Secrets
Learn how to issue, manage, and rotate the API keys used for server-to-server integrations.
Registering an OAuth App
Learn how to register an external app that connects to Receipt Roller using OAuth 2.0.
Webhooks and Event Notifications
Learn how to register webhooks and which events ReceiptRoller sends notifications for.
Store Help Index (Store DX, Digital Receipts, Reservation Management, Retail Media)
This is the ReceiptRoller store help index. It organizes every help article you need for store DX into three categories: customer touchpoints (store app platform, digital receipts, reservation management, retail media including media displays, coupons, CRM, social media management, and AI agent integration), store operations (store data, product management, e-commerce integration, OMS, WMS, shelf analytics, sales analytics, and staff), and account & extensions (getting started, roles and permissions, and the developer API).
Purchase History by Customer (POS Integration)
Learn how to review each customer's receipt-level purchase history from the CRM customer detail screen. Covers the conditions under which POS-issued receipts appear, why scanned paper receipts are excluded, how member matching works, privacy handling, and API access.
Square Transaction Data and Receipt Roller Transaction Data Mapping
A technical explanation of how transaction data fetched from the Square Payment API is mapped into Receipt Roller's transaction data model. Covers the field mapping table, status code conversion, payment method normalization, resolving line items/customer/staff information, OAuth token auto-refresh, and idempotency and timezone handling.
Smaregi Transaction Data and Receipt Roller Transaction Data Mapping
A technical explanation of how transaction data fetched from the Smaregi Platform API is mapped into Receipt Roller's transaction data model. Covers the field mapping table, status code conversion, payment method normalization, resolving line items/customer/staff information, timezone handling, and idempotency.
Connecting a LINE Official Account
Explains how to connect a LINE Official Account to ReceiptRoller using a Messaging API channel's Channel ID and Channel Secret.
Two-Way Member Information Sync with Smaregi/Square
Learn how ReceiptRoller's member information syncs bidirectionally with connected POS systems like Smaregi and Square. Covers which fields sync, sync timing, conflict priority rules, new customer matching, supported POS systems, and troubleshooting.
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.
Owner Permissions
Details the permissions of the Owner role in ReceiptRoller. Covers plan management, full data access, member management, and per-plan Owner limits.
Square POS Integration Setup
Explains how to connect Square POS with ReceiptRoller. Connect easily via OAuth authentication, and accounting data syncs in real time.
Staff Permissions
Details the permissions of the Staff role in ReceiptRoller. The minimum-privilege role for register duty and floor staff, limited to viewing today's transactions and issuing receipts (available on the Free plan).
AI Sales Forecasting
Explains linear extrapolation forecasting for month-end sales and transaction count, and 14-day-ahead demand forecasting (top 5 products, with day-of-week seasonality plus a 20% safety factor). Also covers the 3-tier confidence rating, API/MCP retrieval, and integration with the Sales Analysis by Product AI narrative.
What Is ReceiptRoller — An Integrated DX Platform for Retail
ReceiptRoller is an integrated DX platform that unifies digital receipts, CRM, PIM, retail media, SNS management, shelf analytics, and e-commerce integration — everything retail businesses need — into one platform.
Smaregi x ReceiptRoller — Digital Receipts, Customer Management, and Sales Analysis in One App
Learn how ReceiptRoller Link connects with Smaregi checkouts to unify automatic digital receipt issuance, member management, sales analysis with AI advice, Apple/Google Wallet membership cards, SNS integration, and flyer distribution. Install "ReceiptRoller Link" from the Smaregi App Marketplace to get started today with no complicated API setup required.
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.
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.