Print content on a reader

Print content on a reader's embedded printer.

With Stripe Terminal, you can print custom content—such as receipts, tickets, or other documents—directly on a reader’s embedded printer. This feature is only available for the Verifone V660p reader, which is equipped with an embedded thermal printer capable of printing in black and white.

Generating print content

Your integration is responsible for generating the content to print as an image file. Images are the only format that we support for printing. After you have an image, convert it to the native image representation for your integration type (for example, an image file for server-driven or a Bitmap for Android).

Content guidelines

For best results, we recommend images that are:

At most 384 pixels wide
Black and white (no color)
Designed so that the thinnest part of any character or line is at least 2 pixels wide, to make sure printing is clear and legible

Note

You’re legally responsible for any content submitted to Stripe for printing using readers, and must make sure your receipts comply with applicable law. You’re prohibited from printing receipts containing materials that (i) infringe on the rights of any third party, (ii) violate applicable law, or (iii) contain objectionable, offensive, deceptive, inaccurate, or harmful content.

Printing content

To print content using the JavaScript SDK, pass a native HTMLCanvasElement object to the print method.

Handle the print result

The print method returns a Promise that resolves to an empty object if the print command succeeds. If the command fails, the Promise resolves to an object with an error field. The error object contains an error code, as well as a human-readable message.

The possible values for the code field are:

printer_busy
printer_paperjam
printer_cover_open
printer_out_of_paper
printer_absent
printer_unavailable
printer_error

See the Error codes reference.