Supported POS Integrations (Only)
NCR Silver
Support Program Types (Only)
Points Unlock Redeemables
Point Conversion Type: Staged
Marble <> Punchh Documentation
This document outlines every interaction that is made with Punchh on the Marble apps. The integration can be broken down into 4 separate scopes:
User sign in
Cart checkout
Cart submission
Voiding a transaction
Logging
All requests and responses too and from Punchh are logged by the Marble API. Logs are forwarded too and stored in AWS Cloudwatch.
Networking
Ports
Communication to the Marble API happens on port 443.
Firewall
Marble API is hosted on AWS elastic beanstalk and uses AWS Security groups. A security group acts as a virtual firewall that controls the traffic for one or more instances. It is analogous to a firewall.
Setup
For each location Marble launches that uses Punchh, we need to obtain the:
Location Key
Short Key
Punchh API POS endpoint (ex. https://pos.punchh.com
Punchh Data Sync API End Point (ex. https://isl.punchh.com)
Marble Command Center
All of the Punchh integration settings can be configured in our command center
Brand Settings
Punchh loyalty settings on the brand level include the API host and isl host. To update these navigate to
User > Admin > Brand settings > click Integrations tab
Location Settings
Punchh loyalty settings on the location level include the API location key and short key. To update these settings navigate to”
Locations > <Select Location>> Settings > click Integrations tab.
Interactions
1. User Sign In
2. Cart Checkout
3. Cart Submit
4. Void Ticket