question

bzhang avatar image
bzhang asked Jeffrey Blattman answered

Dynamically creating a custom receipt that works for print and email (Need Confirmation)

Hi Clover,
I was hoping if you could help confirm and correct some of my conclusions, and if you have a full solution for my use case.

Also would like to confirm some functionality since some of the community questions were from years back.

Thanks

Use case:
I would like to print both text and a QR code at the bottom of the receipt.
The text and URL for the QR Code are unrelated and determined based on code in my app and thus not static or the same for all transactions.

Requirement:
Needs to work on both print and email.
Needs to show up for both Order and payment receipts

Order receipts == "Reissue Receipt" in the Order app
Payment receipts == After paying and finishing checkout


Solutions

1/ Smart Receipts
- I provide a base URL and clover appends some unique params, thus generating a dynamic URL to be encoded in a QR Code to show on the receipt.

[BASE_URL]?m=[MERCHANT_ID]&o=[ORDER_ID]&p=[PAYMENT_ID]&c=p

It seems like the intent of smart receipts was to provide an outlet to a URL outside of clover so we can display whatever is needed.

Question 1a/ Does a smart receipt QR code apply to all receipts regardless if a transaction involved a particular line item?
Question 1b/ Is there a way to only inject the QR code if a particular product was purchased for the order?


2/ Receipt Registration + Content Provider
- This allows me to append additional text and image to the bottom of the default clover receipt.
- Since it is part of the sdk, I can dynamically determine what to add tot he bottom based off code in my app and required.

Question 2a: Does this work for email receipts as well? It seems to not work for web receipts.
Question 2b: If we only want to add this additional text/image if a particular line item exits in the order, what should our registered content provider return? null or an empty View?

3/ Order Notes
- This unfortunately requires all merchants to enable Order Notes in Setup app.
Question 3a: Is there a way to add Order notes on a per line item basis?

Solutions I don't think apply to my use case:
1/ Creating custom receipts via Clover connector
https://docs.clover.com/clover-platform/docs/creating-custom-receipts#section-getting-the-devices-printer
This seems to be for creating a mechanism to explicitly print a receipt from the app as opposed to overriding the receipt that gets printed after payment.

What I've dug into:
https://community.clover.com/questions/23/how-can-i-add-textimages-to-customer-receipts.html
https://docs.clover.com/clover-platform/docs/creating-custom-receipts#section-printing-a-custom-receipt
https://community.clover.com/questions/18041/how-to-add-custom-data-following-a-format-on-the-c.html
https://community.clover.com/questions/9540/how-to-update-customer-receipt-with-some-text-afte.html
https://community.clover.com/questions/3344/how-can-i-add-the-dynamic-text-to-email-customer-r.html
https://community.clover.com/questions/16353/custom-receipt-for-custom-tender.html
https://community.clover.com/questions/3289/custom-information-on-standard-receipt.html
https://community.clover.com/questions/12939/how-do-i-show-tip-and-custom-rewards-in-receipt-on.html
https://docs.clover.com/clover-platform/docs/smart-receipts
https://community.clover.com/questions/3344/how-can-i-add-the-dynamic-text-to-email-customer-r.html
https://community.clover.com/questions/10049/web-receipt-add-on.html
https://community.clover.com/questions/3346/how-to-add-text-to-web-receipt-clover-android.html
https://community.clover.com/questions/17871/how-to-show-qrcode-of-order-id-in-recipt.html

Clover Android SDKClover MiniClover Station
2 comments
10 |2000

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.

Hi Clover any answers on this?

0 Likes 0 ·

Hi Clover any answers on this?

0 Likes 0 ·

1 Answer

·
Jeffrey Blattman avatar image
Jeffrey Blattman answered

Smart Receipts is the API that's available.

Does a smart receipt QR code apply to all receipts regardless if a transaction involved a particular line item?

Yes.

Is there a way to only inject the QR code if a particular product was purchased for the order?

No.

Does this work for email receipts as well? It seems to not work for web receipts.

No, it only works for paper receipts.

If we only want to add this additional text/image if a particular line item exits in the order, what should our registered content provider return? null or an empty View?

Null.

Is there a way to add Order notes on a per line item basis?

No, order notes cannot be per-line item. Line items have notes, if that helps.

10 |2000

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.

Write an Answer

Hint: Notify or tag a user in this post by typing @username.

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.

Welcome to the
Clover Developer Community