Set Printing Settings

Please see below for information on configuring the setPrintingSettingsRequest, as well as the expected setPrintingSettingsResponse.

setPrintingSettingsRequest

For a typical request the client must provide the following information:

Field Type Length (chars) Description Example Card terminal support
msgLength String 4 A 4-digit number padded with leading zeros indicating message length minus 4 (including any separators). The request will be rejected if the correct message length is not provided. ‘0063’ Android Card Terminals
sessionId String 6 A unique number to control integrity of session sequence. ‘002690’ Android Card Terminals
msgType String 3 ‘600’ ‘600’ Android Card Terminals
msgCode String 2 ‘00’ ‘00’ Android Card Terminals
businessDescriptionIdentifier String variable up to 12 The business description identifier that will be printed on the receipt if it is enabled. For successful validation, should be one of the following values: 'businessName', 'tradeName', 'storeName' 'businessName' Android Card Terminals
showLogoOnMerchantReceipt String 2 A flag indicating whether the logo will be printed on the receipt of the merchant./td> ‘00’ Android Card Terminals
showVatOnMerchantReceipt String 2 A flag indicating whether the vat number will be printed on the receipt of the merchant./td> ‘00’ Android Card Terminals
printOrderCodeBarcode String 2 A flag indicating whether the barcode will be printed on the receipt./td> ‘00’ Android Card Terminals
businessDescriptionEnabled String 2 A flag indicating whether the business description identifier will be printed on the receipt./td> ‘00’ Android Card Terminals
printAddressOnReceipt String 2 A flag indicating whether the address will be printed on the receipt./td> ‘00’ Android Card Terminals
isMerchantReceiptEnabled String 2 A flag indicating whether the receipt of the merchant will be printed./td> ‘00’ Android Card Terminals
isCustomerReceiptEnabled String 2 A flag indicating whether the receipt of the merchant will be printed./td> ‘00’ Android Card Terminals

The above information elements must be joined into one single string using ‘|’ as a separator. i.e.

0063|002690|600|00|businessName|00|00|00|00|00|00|00

If the resulting string gets appropriately transmitted to the terminal, the terminal will respond with a setPrintingSettingsResponse message (600).

setPrintingSettingsResponse

In a setPrintingSettingsRequest the terminal responds with a setPrintingSettingstResponse to indicate if the transaction has been approved or not.

A setPrintingSettingsResponse for an approved transaction looks as follows:

0048|000015|610|IP|00|businessName|00|00|00|00|00|00

The table below summarises the contents of the response.

Field Length (chars) Description Example Card terminal support
msgLength 4 A 4-digit number padded with leading zeros indicating the length of the message that follows (including separators). Note that this is the total number of bytes and not of characters (in some languages, some characters consist of 2 bytes). '0129' Android Card Terminals
seqTxnId 6 A 6 digit number matching the value sent in seqTnxNum field of the preceding txReady message. '000032' Android Card Terminals
msgTypeResp 3 '710' '710' Android Card Terminals
respCode 2 Approval status. '00' indicates approval. All other values indicate failure codes. See failure code table at the end. '00' Android Card Terminals
businessDescriptionIdentifier variable up to 12 The business description identifier that will be printed on the receipt if it is enabled. For successful validation, should be one of the following values: 'businessName', 'tradeName', 'storeName' 'businessName' Android Card Terminals
showLogoOnMerchantReceipt 2 A flag indicating whether the logo will be printed on the receipt of the merchant./td> ‘00’ Android Card Terminals
showVatOnMerchantReceipt 2 A flag indicating whether the vat number will be printed on the receipt of the merchant./td> ‘00’ Android Card Terminals
printOrderCodeBarcode 2 A flag indicating whether the barcode will be printed on the receipt./td> ‘00’ Android Card Terminals
businessDescriptionEnabled 2 A flag indicating whether the business description identifier will be printed on the receipt./td> ‘00’ Android Card Terminals
printAddressOnReceipt 2 A flag indicating whether the address will be printed on the receipt./td> ‘00’ Android Card Terminals
isMerchantReceiptEnabled 2 A flag indicating whether the receipt of the merchant will be printed./td> ‘00’ Android Card Terminals
isCustomerReceiptEnabled 2 A flag indicating whether the receipt of the merchant will be printed./td> ‘00’ Android Card Terminals

Get Support

If you have any questions about our solutions, or questions about how to integrate with our solutions, please refer to our Get Support page.