Configuring Digital Receipt

Digital Receipt as E-Mail

For this option, the customer has to provide their e-mail address. This can be done by scanning a QR code that includes the e-mail address or by entering the e-mail address manually.

If you want the POS Client to ask about the e-mail option for every sales transaction, then the following configuration must be used:paymentEndConfigs.properties:

PaymentEndConfigs.Default.askForReceiptAsEmail=true

If an e-mail address was assigned to the transaction, the digital receipt (PDF) is created. The e-mail will be sent directly by the POS Client if:

paymentEndConfigs.properties:

PaymentEndConfigs.Default.digitalReceiptEmailAction=Client

or it will be sent by the POS Server agent if:

paymentEndConfigs.properties:

PaymentEndConfigs.Default.digitalReceiptEmailAction=Backend

If the e-mail should be sent by the POS Client, then the digital receipt service needs to be configured:

webServiceServerConfig.properties:

 WebServiceServerConfig.DigitalReceiptService.adress=https://localhost
WebServiceServerConfig.DigitalReceiptService.timeout=5000
 WebServiceServerConfig.DigitalReceiptService.connectionTimeout=3000
WebServiceServerConfig.DigitalReceiptService.username={user name}
 WebServiceServerConfig.DigitalReceiptService.password={password}

To activate the subsequent posting of the digital receipt, the digital receipt agent has to be configured. For details, refer to the chapter "Digital Receipt Service" in the Customizing Guide – POS Server.

Digital Receipt as a Download Link

This option can be enabled by setting the following configuration:

paymentEndConfigs.properties:

PaymentEndConfigs.Default.digitalReceiptAction=QRCode

If this configuration is enabled and no e-mail address was assigned to the transaction, then the POS Client will ask if the customer wants a digital receipt for each transaction. If this is confirmed by the operator, then a digital receipt (PDF) is created and uploaded to the digital receipt service:

webServiceServerConfig.properties:

 WebServiceServerConfig.DigitalReceiptService.adress=https://localhost
WebServiceServerConfig.DigitalReceiptService.timeout=5000
 WebServiceServerConfig.DigitalReceiptService.connectionTimeout=3000
WebServiceServerConfig.DigitalReceiptService.username={user name}
 WebServiceServerConfig.DigitalReceiptService.password={password}

Once the upload is successful, a download link is created and encoded as a QR code so that the customer can scan it. The URL of the download link needs to be configured in the following way:

paymentEndConfigs.properties:

PaymentEndConfigs.Default.digitalReceiptDownloadLinkURL=https://localhost/api/v1/transaction/getPosLogPdf