Terminal receipt configuration

Receipt printing request fields

By default, the POS is responsible for printing receipts and handling signature verification. The following request fields let you delegate some or all of this to the terminal instead.

These fields are supported on all transaction requests.

Field	Type	Default	Description
`print_merchant_receipt`	boolean	`false`	If `true`, the terminal prints the merchant receipt instead of the POS
`prompt_customer_receipt`	boolean	`false`	If `true`, the terminal prompts the customer about their receipt preference
`verify_signature_on_terminal`	boolean	`false`	If `true`, the terminal prints the signature receipt and handles all signature verification steps. See Purchases, refunds and signatures
`pos_auto_print_signature_receipt`	boolean	`false`	If `true`, the POS automatically prints the merchant receipt when a signature is required, rather than rendering a Print button. See Purchases, refunds and signatures

Recommended implementation

Expose these as toggles in your POS settings so merchants can configure their preferred receipt behaviour. As a reference point, the mx51 demo POS application Espresso POS is available.

The recommended defaults are:

Setting	Default
Terminal prints merchant receipt	Off
Terminal prompts for customer receipt	Off
EFTPOS signature flow (terminal handles signature)	Off
Auto-print signature receipt from POS	On

📘
The auto-print signature receipt toggle (Option 1 vs Option 2 in the signature flow) defaults to On - most merchants prefer the receipt to print automatically. See Purchase, refund and signature for the full signature flow.