Skip to main content
Receipt promotion endpoints allow you to retrieve promotional content to display on customer receipts. This enables you to deliver personalized offers, next-visit coupons, and marketing messages at the point of sale.

​
What are Receipt Promotions?

Receipt promotions are targeted marketing messages displayed on customer receipts after purchase. They help:
  • Drive Repeat Visits: Offer next-visit discounts and incentives
  • Cross-Sell Products: Recommend related items based on purchase history
  • Build Loyalty: Deliver personalized rewards and birthday offers
  • Increase Engagement: Encourage app downloads and program enrollment

​
How It Works

Customer Completes Purchase

Transaction is completed at the POS terminal.

Retrieve Promotion Content

Call the receipt promotion endpoint with your location ID to get promotional content.

Display on Receipt

Print the promotion text, QR code, or barcode on the customer receipt.

​
Receipt Promotion Endpoints

Get Receipt Promotion Details

Retrieve promotion content for a specific location

Create POS Transaction

Send transaction data that can trigger receipt promotions

​
Best Practices

Retrieve After Transaction

Call the receipt promotion endpoint after completing the transaction to ensure you get the most relevant offers based on the purchase.
Cache promotion content per location but refresh regularly (every 15-30 minutes) to ensure current offers are displayed.
Not all locations have active receipt promotions. Gracefully handle empty responses without displaying errors to customers.
Ensure promotion text fits your receipt printer width. Test QR codes and barcodes for scannability on thermal printers.

​
Next Steps

Receipt Promotion API Reference

View complete API specification

POS Receipt Integration Guide

Step-by-step implementation guide