> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clearline.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction to Receipt Promotions

> Display targeted marketing content on customer receipts

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

<Steps>
  <Step title="Customer Completes Purchase" icon="receipt">
    Transaction is completed at the POS terminal.
  </Step>

  <Step title="Retrieve Promotion Content" icon="download">
    Call the [receipt promotion
    endpoint](/api-reference/pos-receipt/get-receipt-promotion-details) with
    your location ID to get promotional content.
  </Step>

  <Step title="Display on Receipt" icon="print">
    Print the promotion text, QR code, or barcode on the customer receipt.
  </Step>
</Steps>

## Receipt Promotion Endpoints

<CardGroup cols={2}>
  <Card title="Get Receipt Promotion Details" icon="file-invoice" href="/api-reference/pos-receipt/get-receipt-promotion-details">
    Retrieve promotion content for a specific location
  </Card>

  <Card title="Create POS Transaction" icon="receipt" href="/api-reference/transactions/create-pos-transaction">
    Send transaction data that can trigger receipt promotions
  </Card>
</CardGroup>

## Best Practices

<AccordionGroup>
  <Accordion title="Retrieve After Transaction" icon="clock" defaultOpen>
    Call the receipt promotion endpoint after completing the transaction to
    ensure you get the most relevant offers based on the purchase.
  </Accordion>

  {" "}

  <Accordion title="Cache Promotions Smartly" icon="database">
    Cache promotion content per location but refresh regularly (every 15-30
    minutes) to ensure current offers are displayed.
  </Accordion>

  {" "}

  <Accordion title="Handle Missing Promotions" icon="circle-exclamation">
    Not all locations have active receipt promotions. Gracefully handle empty
    responses without displaying errors to customers.
  </Accordion>

  <Accordion title="Format for Receipt Printers" icon="print">
    Ensure promotion text fits your receipt printer width. Test QR codes and
    barcodes for scannability on thermal printers.
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Receipt Promotion API Reference" icon="code" href="/api-reference/pos-receipt/get-receipt-promotion-details">
    View complete API specification
  </Card>

  <Card title="POS Receipt Integration Guide" icon="book-open" href="/pos-integration/pos-receipt-promotion">
    Step-by-step implementation guide
  </Card>
</CardGroup>