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.
Registering an OAuth App
Learn how to register an external app that connects to Receipt Roller using OAuth 2.0.
API Keys and Client Secrets
Learn how to issue, manage, and rotate the API keys used for server-to-server integrations.
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).
Self-Service Submission Wizard (App Store / Google Play)
The relay router's store app platform provides a wizard that lets store owners handle native app builds for iOS / Android and submission to the App Store / Google Play entirely from the admin screen. This article covers the wizard flow, required information, asset auto-generation, store operations, and how to track submission status.
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.
Posting to SNS from an AI Agent (MCP Integration)
A guide to posting in natural language to SNS channels connected to ReceiptRoller from AI agents like Claude. Covers drafting posts, posting to multiple channels at once, scheduled posts, and attaching images, all through conversation. Includes concrete phrasing examples and tips.
Owner Permissions
Details the permissions of the Owner role in ReceiptRoller. Covers plan management, full data access, member management, and per-plan Owner limits.
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).
Square POS Integration Setup
Explains how to connect Square POS with ReceiptRoller. Connect easily via OAuth authentication, and accounting data syncs in real time.
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.
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.
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.
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.
Smaregi Customer Data and Receipt Roller Customer Data Mapping
Explains how Smaregi's customer master is converted into Receipt Roller's customer data (CrmCustomerDto), field by field. Covers the membership number, name, contact info, and date-of-birth correspondence, the priority between mobile and landline numbers, and webhook-based sync timing.
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.
Plans and Roles (Free Plan Limitations)
Explains how ReceiptRoller roles differ depending on your plan. Includes a table showing which roles are available on the Free, Starter, Growth, and Enterprise plans.
Overview of Apple Wallet / Google Wallet Membership Cards
The relay router's store app platform can issue your store's original membership card on both Apple Wallet (iPhone) and Google Wallet (Android). This article covers what a Wallet membership card is, the benefits for customers and stores, what's displayed, POS integration, and the setup flow.