Epson OmniLink Merchant Services V3 Development Guide
Epson OmniLink Merchant Services V3 Manual
View all Epson OmniLink Merchant Services V3 manuals
Add to My Manuals
Save this manual to your list of manuals |
Epson OmniLink Merchant Services V3 manual content summary:
- Epson OmniLink Merchant Services V3 | Development Guide - Page 1
OmniLink Merchant Services Development Guide M00122600 EN - Epson OmniLink Merchant Services V3 | Development Guide - Page 2
necessary information to configure a development environment for developing OmniLink Merchant Services (cloud-based applications) and migration of developed services to production environments for system developers. Setup Guide This manual is for an installer who installs TM printers in stores - Epson OmniLink Merchant Services V3 | Development Guide - Page 3
Epson OmniLink Merchant Services Development Guide Introduction Usage Limitations Please use our products in reward point program, etc., that is developed by a Service provider. Meaning of Symbols The following symbols are used in this manual. Make sure to understand the meaning of these symbols - Epson OmniLink Merchant Services V3 | Development Guide - Page 4
Guide Contents Contents Introduction 2 Manuals 2 Precautions 2 Usage Limitations 3 Terms and Symbols Used in the Manuals 3 Terms 3 Meaning of Symbols 3 OmniLink Merchant Services Hierarchy and Work Flow 6 OmniLink Merchant Services Hierarchy 6 Overview of Service Development 8 Service - Epson OmniLink Merchant Services V3 | Development Guide - Page 5
Services Development Guide Contents Receipt mapping 61 QR Code Setting 82 Contents Print Setting 94 Data Filtering and Masking Setting 105 Scanner Transmission Setting 117 Migrate to the Production Environment 128 Migrating the Service 128 Changing the Printer Setting 128 Troubleshooting - Epson OmniLink Merchant Services V3 | Development Guide - Page 6
Epson OmniLink Merchant Services Development Guide OmniLink Merchant Services Hierarchy and Work Flow OmniLink Merchant Services Hierarchy and Work Flow OmniLink Merchant Services Hierarchy The Team Administrator registered by Epson creates the groups necessary to use OmniLink Merchant Services and - Epson OmniLink Merchant Services V3 | Development Guide - Page 7
Epson OmniLink Merchant Services Development Guide OmniLink Merchant Services Hierarchy and Work Flow Team Group N Group 2 Group 1 Store 1 Store 2 Store N Printer 1 Printer 2 Printer N Printer 1 Printer 2 Printer N Printer 1 Printer 2 Printer N 7 - Epson OmniLink Merchant Services V3 | Development Guide - Page 8
of the sandbox environment enables you to retrieve receipt data without connecting actual printers to OmniLink Merchant Services. Receipt data is retrieved using a Web API. Refer to Web API Reference Guide for more information on using the Web API. Stores must also be registered in the sandbox - Epson OmniLink Merchant Services V3 | Development Guide - Page 9
Epson OmniLink Merchant Services Development Guide OmniLink Merchant Services Hierarchy and Work Flow Service Development Work Flow Service provider(Administrator) Sign in U "Sign in" on page 11 Deployment partner (Administrator) Register test groups* U "Registering Groups" on page 14 Register - Epson OmniLink Merchant Services V3 | Development Guide - Page 10
Epson OmniLink Merchant Services Development Guide OmniLink Merchant Services Hierarchy and Work Flow Service provider(Administrator) Contact Epson when service development is complete Deployment partner (Administrator) *: Test groups and stores used for development must be registered. - Epson OmniLink Merchant Services V3 | Development Guide - Page 11
OmniLink Merchant Services Development Guide Configure the Development/Production Environment Configure the Development/Production Environment Epson provides two environments for OmniLink Merchant Services: Sandbox environment: Used for development and testing of services. Production environment - Epson OmniLink Merchant Services V3 | Development Guide - Page 12
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment C Read the terms of use and other information, and then select the check box to indicate your agreement. Next, enter a - Epson OmniLink Merchant Services V3 | Development Guide - Page 13
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Signing Out This section describes the signout procedure. A Click at the upper-right of the screen. B Click Sign out. 13 - Epson OmniLink Merchant Services V3 | Development Guide - Page 14
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Registering Groups Registering Groups With OmniLink Merchant Services, multiple stores are managed as groups. During developing services test stores and groups may be used. However, in the production - Epson OmniLink Merchant Services V3 | Development Guide - Page 15
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Item Description Decline of data classification rate (%) Specifies the rate of decline when comparing the current data classification rate with - Epson OmniLink Merchant Services V3 | Development Guide - Page 16
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment D Check the currently registered information and then click Edit in Group. E Modify the group name and other values. Item Description - Epson OmniLink Merchant Services V3 | Development Guide - Page 17
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Deleting Groups This section describes the procedure to deletes groups. Groups with registered stores cannot be deleted. Delete the stores - Epson OmniLink Merchant Services V3 | Development Guide - Page 18
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment D Click Delete in Group. E Confirm the message and click Delete. 18 - Epson OmniLink Merchant Services V3 | Development Guide - Page 19
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Managing Members Registering Members Register members who use OmniLink Merchant Services. A member must belong to one team. Select the team and add members. A Access the OmniLink Management Console - Epson OmniLink Merchant Services V3 | Development Guide - Page 20
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment D Configure the following setting items and click Save. The * indicates required field. Item ID (Email) ID (Email) (Confirm) Administrator Description - Epson OmniLink Merchant Services V3 | Development Guide - Page 21
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Deleting Members This section describes the procedure to delete members in a team. A Access the OmniLink Management Console and sign in. U " - Epson OmniLink Merchant Services V3 | Development Guide - Page 22
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment E Confirm the message and click Delete . 22 - Epson OmniLink Merchant Services V3 | Development Guide - Page 23
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Assigning Members to Groups Members can only access information on stores and printers when the members, stores, and printers are all in the same group. During developing services test members and - Epson OmniLink Merchant Services V3 | Development Guide - Page 24
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment D Click Edit in Members. E Select the desired check boxes to give each member specific rights and then click Save. Note: - Epson OmniLink Merchant Services V3 | Development Guide - Page 25
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment F Check that the members have been assigned to the group. What rights have been assigned to which members can be verified. 25 - Epson OmniLink Merchant Services V3 | Development Guide - Page 26
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Managing Stores Note: Up to 50,000 stores can be registered into one group. Registering Stores Register the stores using OmniLink Merchant Services and then select the services that will be used by - Epson OmniLink Merchant Services V3 | Development Guide - Page 27
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment D Enter the store information in the Store Information section. The * indicates required field. Item Brand Name Store Name Tags Address 1 - Epson OmniLink Merchant Services V3 | Development Guide - Page 28
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Item Email Timezone Language on the POS device. Select the currency used on the POS device. E In the Services section, select the check boxes assigned to the team and then click Save. Viewing Store - Epson OmniLink Merchant Services V3 | Development Guide - Page 29
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment C Click Stores if nothing stores and printers can be registered at the same time. Refer to the Setup Guide for more information. d Filter the display content based on store name, serial number - Epson OmniLink Merchant Services V3 | Development Guide - Page 30
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Changing Store Information This section describes the procedure to change store information. A Access the OmniLink Management Console and sign in. U " - Epson OmniLink Merchant Services V3 | Development Guide - Page 31
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment D Check the currently registered information and then click Edit. E Edit the following setting items and click Save on the bottom - Epson OmniLink Merchant Services V3 | Development Guide - Page 32
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Deleting Stores This section describes the procedure to delete registered stores. A Access the OmniLink Management Console and sign in. U "Sign - Epson OmniLink Merchant Services V3 | Development Guide - Page 33
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment D Click Delete. E Confirm the message and click Delete. 33 - Epson OmniLink Merchant Services V3 | Development Guide - Page 34
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Managing Printers Registering Printers Even without actual printers, you can use the sample receipt feature to issue receipt data in - Epson OmniLink Merchant Services V3 | Development Guide - Page 35
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment D In the Devices section, click Add. E Configure the following setting items and click Save on the bottom of the screen. - Epson OmniLink Merchant Services V3 | Development Guide - Page 36
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Printer Information The * indicates required field. Item Model Serial # Serial # (confirm) Connected POS Name Location Description Description Select the TM - Epson OmniLink Merchant Services V3 | Development Guide - Page 37
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Viewing Printer Information This section describes the procedure to view printer information. A Access the OmniLink Management Console and sign in. U " - Epson OmniLink Merchant Services V3 | Development Guide - Page 38
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment E Click Printer Setting. F View the printer information. 38 - Epson OmniLink Merchant Services V3 | Development Guide - Page 39
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Changing Printer Information This section describes the procedure to change printer information. A Access the OmniLink Management Console and sign in. U " - Epson OmniLink Merchant Services V3 | Development Guide - Page 40
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment E Click Printer Setting. F Check the currently registered information and then click Edit. 40 - Epson OmniLink Merchant Services V3 | Development Guide - Page 41
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment G Edit the following setting items and click Save on the bottom of the screen. See "Registering Printers" on page 34 - Epson OmniLink Merchant Services V3 | Development Guide - Page 42
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment C Click the store with the printer information you want to delete. D In the Devices section, click the printer you want to delete. E Click Printer Setting. 42 - Epson OmniLink Merchant Services V3 | Development Guide - Page 43
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment F Click Delete. G Confirm the message and click Delete. 43 - Epson OmniLink Merchant Services V3 | Development Guide - Page 44
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Using the Sample Receipt Function With the sample receipt function, you can uploaded editable receipt data to sandbox services. Note: The sample receipt function can only be used in the sandbox - Epson OmniLink Merchant Services V3 | Development Guide - Page 45
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment E Click Test. F Select either Restaurant or Retail for the category. 45 - Epson OmniLink Merchant Services V3 | Development Guide - Page 46
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment G Select the sample receipt you want to use. H Edit the receipt data as necessary. Note: The receipt ID is a random - Epson OmniLink Merchant Services V3 | Development Guide - Page 47
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment I Click Upload Sample Receipt to upload receipt data to the server. J Click OK. Use the following procedure to verify that the uploaded sample receipt was received correctly. K Click Summary. 47 - Epson OmniLink Merchant Services V3 | Development Guide - Page 48
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment L If Received appears for Transaction under Status, the date of Latest Transaction is the date that the sample receipt was issued. M Click to display the Latest Transaction information. 48 - Epson OmniLink Merchant Services V3 | Development Guide - Page 49
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment N Check that the receipt data sent in step 9 appears. Click to return to the previous screen. Click Reload to retrieve the Latest Transaction information again. 49 - Epson OmniLink Merchant Services V3 | Development Guide - Page 50
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Connecting Printers to OmniLink Merchant Services Set up the TM printers and configure the network settings to use the OmniLink Merchant Services. This section does not need to be read if using the - Epson OmniLink Merchant Services V3 | Development Guide - Page 51
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Connecting the TM Printers Connect the TM printer to a POS system. Network Settings Configure the network settings using TM-T88VI Utility. For more details, see User's Manual of TM-T88VI Utility. 51 - Epson OmniLink Merchant Services V3 | Development Guide - Page 52
Merchant Services Development Guide Configure the Development/Production Environment Connecting to the Cloud Server Connect the TM printer to the sandbox or production environment. A Start TM-T88VI Utility. Select Detailed Settings from TM-Intelligent, then click OmniLink Merchant Services. B Select - Epson OmniLink Merchant Services V3 | Development Guide - Page 53
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment C Configure the proxy server settings if necessary. 1. Select Server Access from enter the URL, ID, password, and port of the proxy server. Then set the OmniLink Merchant Service option to Enabled. 53 - Epson OmniLink Merchant Services V3 | Development Guide - Page 54
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment D Click Set to apply the cgi o For information on how to check the printer's IP address, see the User's Manual of TM-T88VI Utility. F Change the end point of printers. North America region Sandbox - Epson OmniLink Merchant Services V3 | Development Guide - Page 55
to the sandbox or production. Note: For information on how to print the status sheet, see Technical Reference Guide of the corresponding printer. Check the "OmniLink Merchant Service" field on the status sheet. When the printer is connected to the sandbox or production server, printed as shown - Epson OmniLink Merchant Services V3 | Development Guide - Page 56
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Checking Advanced Printer Driver Settings If using the Advanced Printer Driver, follow the procedure below to substitute the font types. - Epson OmniLink Merchant Services V3 | Development Guide - Page 57
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment C Click Font Replacement. D Select a substitute Device Font appropriate for each True Type Font, and click Set. 57 - Epson OmniLink Merchant Services V3 | Development Guide - Page 58
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Checking the Receipt Data Send Results After printing a receipt to the TM printer, the receipt data is forwarded to the - Epson OmniLink Merchant Services V3 | Development Guide - Page 59
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment D In the Devices section, click the printer used to check receipt data. E If Received appears for Transaction under Status, the - Epson OmniLink Merchant Services V3 | Development Guide - Page 60
Epson OmniLink Merchant Services Development Guide Configure the Development/ , check the POS system to see if it prints text data. OmniLink Merchant Services does not support image data. If using the Advanced Printer Driver refer to, U "Checking Advanced see the User's Manual of TM-T88VI Utility. 60 - Epson OmniLink Merchant Services V3 | Development Guide - Page 61
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Configuring Printers With OmniLink Management Console, the following print and data settings can be configured. These settings can be saved - Epson OmniLink Merchant Services V3 | Development Guide - Page 62
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment D Click the store from which you to perform the receipt mapping process. E In the Devices section, click the printer for - Epson OmniLink Merchant Services V3 | Development Guide - Page 63
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment G Click Edit in Receipt Mapping. Note: The version currently applied to the printer is displayed under Version Name. H Configure the search criteria and then click Search. 63 - Epson OmniLink Merchant Services V3 | Development Guide - Page 64
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Select Sort Order Date Range Item Unmapped Mapped By GUID Description Displays unmapped receipt data. Displays mapped receipt data. Displays receipt data specified by GUID. Specifies the sort order - Epson OmniLink Merchant Services V3 | Development Guide - Page 65
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment J Configure data mapping rules following the Data Mapping screen instructions. Note: o Refer to Workflow Overview at the upper-right of the screen for information on the procedure to configure data - Epson OmniLink Merchant Services V3 | Development Guide - Page 66
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment L Confirm the message and then click Remap. M Confirm the message and then click OK. The configured content is saved as a - Epson OmniLink Merchant Services V3 | Development Guide - Page 67
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment P Enter the Name and Comment and then click Save. Q Confirm that receipt data is retrieved correctly via services. 67 - Epson OmniLink Merchant Services V3 | Development Guide - Page 68
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Screens and Functions This section describes the configuration of the Data Mapping screen. Note: Moving the mouse pointer over the - Epson OmniLink Merchant Services V3 | Development Guide - Page 69
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Receipt This tab displays settings properties of receipt data mapping rules. Item Printed at Products Receipt ID Total Consumer ID - Epson OmniLink Merchant Services V3 | Development Guide - Page 70
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Item Payment methods Sales type Staff Subtotal Taxes Description Breakdown of sales total by payment method. A sales type descriptor indicating - Epson OmniLink Merchant Services V3 | Development Guide - Page 71
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Shift This tab displays settings properties of shift data mapping rules regarding shift information of the staff members. Item Date - Epson OmniLink Merchant Services V3 | Development Guide - Page 72
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Data Mapping This section is used to configure data mapping rules for the settings properties selected in "Properties" on page - Epson OmniLink Merchant Services V3 | Development Guide - Page 73
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Setting Screen a b c d e f Description a Cancels the selected property settings. b Clears the configured rules selected in section e . Maps receipt data per the - Epson OmniLink Merchant Services V3 | Development Guide - Page 74
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment a Cancels the selected property settings. b Resets property settings. c Applies configured data mapping rules. d Displays the contact form. e Displays mapping results. - Epson OmniLink Merchant Services V3 | Development Guide - Page 75
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Receipt/Report/Shift These tabs display receipt data that you want to use to configure data mapping rules. This section - Epson OmniLink Merchant Services V3 | Development Guide - Page 76
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Changing the Applicable Version The applicable version can be changed. The applicable version can be selected from versions registered in - Epson OmniLink Merchant Services V3 | Development Guide - Page 77
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment E Click Other Settings. F Click Edit in Receipt Mapping. Note: The version currently applied to the printer is displayed under Version Name. 77 - Epson OmniLink Merchant Services V3 | Development Guide - Page 78
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment G Click Load Version. H Enter the name of the desired version name and then click . I From the list, select the desired - Epson OmniLink Merchant Services V3 | Development Guide - Page 79
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Copying Versions to Other Groups The version can be copied to another group so that the same version can be - Epson OmniLink Merchant Services V3 | Development Guide - Page 80
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment E Click Other Settings. F Click Edit in Receipt Mapping. Note: The version currently applied to the printer is displayed under Version Name. 80 - Epson OmniLink Merchant Services V3 | Development Guide - Page 81
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment G Click Manage Versions. H Select the version to copy and then click Copy to Another Group. 81 - Epson OmniLink Merchant Services V3 | Development Guide - Page 82
Epson OmniLink Merchant Services Development Guide Configure the Development/Production includes a unique ID. The ID is used to associate the physical receipt with OmniLink Merchant Services data. Creating and Applying Versions A Access the OmniLink Management Console and sign in. U "Sign - Epson OmniLink Merchant Services V3 | Development Guide - Page 83
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment C Click the store for which you want to configure QR code settings. D In the Devices section, click the printer for which you want to configure QR code settings. E Click Other Settings. 83 - Epson OmniLink Merchant Services V3 | Development Guide - Page 84
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment F Click Edit in QR Code. Note: The version currently applied to the printer is displayed under Version Name. G Check the currently registered information and then click Edit. 84 - Epson OmniLink Merchant Services V3 | Development Guide - Page 85
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment H Configure the following setting items and click Save on the bottom of the screen. Item Print QR Base URL Regex - Epson OmniLink Merchant Services V3 | Development Guide - Page 86
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Sample Bold Centering Underline Sample text and commands \x1B\x45\x01This is a bold text. \x1B\x45\x00\x0A \x1B\x61\ - Epson OmniLink Merchant Services V3 | Development Guide - Page 87
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment K Enter the Name and Comment and then click Save. Changing the Applicable Version The applicable version can be changed. The - Epson OmniLink Merchant Services V3 | Development Guide - Page 88
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment C Click the store for which you want to change the version. D In the Devices section, click the printer for which you want to change the version. E Click Other Settings. 88 - Epson OmniLink Merchant Services V3 | Development Guide - Page 89
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment F Click Edit in QR Code. Note: The version currently applied to the printer is displayed under Version Name. G Click Load Version. 89 - Epson OmniLink Merchant Services V3 | Development Guide - Page 90
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment H Enter the name of the desired version name and then click . I From the list, select the desired version and then - Epson OmniLink Merchant Services V3 | Development Guide - Page 91
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment C Click the store for which you want to copy the version from. D In the Devices section, click the printer for which you want to copy the version from. E Click Other Settings. 91 - Epson OmniLink Merchant Services V3 | Development Guide - Page 92
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment F Click Edit in QR Code. Note: The version currently applied to the printer is displayed under Version Name. G Click Manage Versions. 92 - Epson OmniLink Merchant Services V3 | Development Guide - Page 93
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment H Select the version to copy and then click Copy to Another Group. I Enter the Name and Comment, select the check - Epson OmniLink Merchant Services V3 | Development Guide - Page 94
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Contents Print Setting The printing of image content sent to the printer beforehand can be triggered with matching conditions, such - Epson OmniLink Merchant Services V3 | Development Guide - Page 95
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment E Click Other Settings. F Click Edit in Contents Print. Note: The version currently applied to the printer is displayed under Version Name. 95 - Epson OmniLink Merchant Services V3 | Development Guide - Page 96
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment G Check the currently registered information and then click Edit. H Configure the following setting items and click Save on the bottom - Epson OmniLink Merchant Services V3 | Development Guide - Page 97
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Item black-and-white in the format when actually printed on receipts. The following image types and sizes are supported. o Image size: Max. 500 pixels in width and 700 pixels in height o Image format: - Epson OmniLink Merchant Services V3 | Development Guide - Page 98
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment J Select the previously registered version and then click Edit. K Enter the Name and Comment and then click Save. Changing the - Epson OmniLink Merchant Services V3 | Development Guide - Page 99
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment B From Team & Group , select the team and then the group for which you want to change the version. C Click the - Epson OmniLink Merchant Services V3 | Development Guide - Page 100
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment E Click Other Settings. F Click Edit in Contents Print. 100 - Epson OmniLink Merchant Services V3 | Development Guide - Page 101
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment G Click Load Version. Note: The version currently applied to the printer is displayed under Version Name. H Enter the name of - Epson OmniLink Merchant Services V3 | Development Guide - Page 102
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Copying Versions to Other Groups The version can be copied to another group so that the same version can be - Epson OmniLink Merchant Services V3 | Development Guide - Page 103
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment E Click Other Settings. F Click Edit in Contents Print. 103 - Epson OmniLink Merchant Services V3 | Development Guide - Page 104
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment G Click Manage Versions. H Select the version to copy and then click Copy to Another Group. 104 - Epson OmniLink Merchant Services V3 | Development Guide - Page 105
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment I Enter the Name and Comment, select the check box of the group you want to copy to and then click - Epson OmniLink Merchant Services V3 | Development Guide - Page 106
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment C Click the store for which you want to configure data filtering and masking settings. D In the Devices section, click the - Epson OmniLink Merchant Services V3 | Development Guide - Page 107
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment F Click Edit in Data Filtering and Masking. Note: The version currently applied to the printer is displayed under Version Name. G Check the currently registered information and then click Edit. 107 - Epson OmniLink Merchant Services V3 | Development Guide - Page 108
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment H Configure the following setting items and click Save. Item Enable data filtering and masking Filter type Regex pattern to trigger - Epson OmniLink Merchant Services V3 | Development Guide - Page 109
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment I Click Manage Versions. J Select the previously registered version and then click Edit. 109 - Epson OmniLink Merchant Services V3 | Development Guide - Page 110
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment K Enter the Name and Comment and then click Save. Changing the Applicable Version The applicable version can be changed. The - Epson OmniLink Merchant Services V3 | Development Guide - Page 111
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment C Click the store for which you want to change the version. D In the Devices section, click the printer for which you want to change the version. E Click Other Settings. 111 - Epson OmniLink Merchant Services V3 | Development Guide - Page 112
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment F Click Edit in Data Filtering and Masking. Note: The version currently applied to the printer is displayed under Version Name. G Click Load Version. 112 - Epson OmniLink Merchant Services V3 | Development Guide - Page 113
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment H Enter the name of the desired version name and then click . I From the list, select the desired version and then - Epson OmniLink Merchant Services V3 | Development Guide - Page 114
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment C Click the store for which you want to copy the version from. D In the Devices section, click the printer for which you want to copy the version from. E Click Other Settings. 114 - Epson OmniLink Merchant Services V3 | Development Guide - Page 115
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment F Click Edit in Data Filtering and Masking. Note: The version currently applied to the printer is displayed under Version Name. G Click Manage Versions. 115 - Epson OmniLink Merchant Services V3 | Development Guide - Page 116
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment H Select the version to copy and then click Copy to Another Group. I Enter the Name and Comment, select the check - Epson OmniLink Merchant Services V3 | Development Guide - Page 117
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Scanner Transmission Setting Sending of data read by a scanner connected to a printer to the server can be enabled/disabled (filtering). - Epson OmniLink Merchant Services V3 | Development Guide - Page 118
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment E Click Other Settings. F Click Edit in Scanner Transmission. Note: The version currently applied to the printer is displayed under Version Name. 118 - Epson OmniLink Merchant Services V3 | Development Guide - Page 119
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment G Check the currently registered information and then click Edit. H Configure the following setting items and click Save. Item Scanner transmission - Epson OmniLink Merchant Services V3 | Development Guide - Page 120
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment Item Regex pattern to filter scanned data Description Use a regular expression to enter the conditions by which the sending of - Epson OmniLink Merchant Services V3 | Development Guide - Page 121
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment K Enter the Name and Comment and then click Save. Changing the Applicable Version The applicable version can be changed. The - Epson OmniLink Merchant Services V3 | Development Guide - Page 122
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment C Click the store for which you want to change the version. D In the Devices section, click the printer for which you want to change the version. E Click Other Settings. 122 - Epson OmniLink Merchant Services V3 | Development Guide - Page 123
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment F Click Edit in Scanner Transmission. Note: The version currently applied to the printer is displayed under Version Name. G Click Load Version. 123 - Epson OmniLink Merchant Services V3 | Development Guide - Page 124
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment H Enter the name of the desired version name and then click . I From the list, select the desired version and then - Epson OmniLink Merchant Services V3 | Development Guide - Page 125
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment C Click the store for which you want to copy the version from. D In the Devices section, click the printer for which you want to copy the version from. E Click Other Settings. 125 - Epson OmniLink Merchant Services V3 | Development Guide - Page 126
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment F Click Edit in Scanner Transmission. Note: The version currently applied to the printer is displayed under Version Name. G Click Manage Versions. 126 - Epson OmniLink Merchant Services V3 | Development Guide - Page 127
Epson OmniLink Merchant Services Development Guide Configure the Development/Production Environment H Select the version to copy and then click Copy to Another Group. I Enter the Name and Comment, select the check - Epson OmniLink Merchant Services V3 | Development Guide - Page 128
Epson OmniLink Merchant Services Development Guide Migrate to the Production Environment Migrate to the Production Environment When your service (application) is fully integrated and tested using the sandbox environment, migrate it to the production environment to use printers installed in stores - Epson OmniLink Merchant Services V3 | Development Guide - Page 129
Epson OmniLink Merchant Services Development Guide Migrate to the Production Environment C Reboot printer. D Print a status sheet and check that the connection destination server has been set to omnilinkworld.com" (North America - Epson OmniLink Merchant Services V3 | Development Guide - Page 130
Epson OmniLink Merchant Services Development Guide Troubleshooting Troubleshooting Problem Check Description Cannot print. Is the roll paper loaded in the printer? Is the roll paper loaded in the correct direction? Is printer power on? - Epson OmniLink Merchant Services V3 | Development Guide - Page 131
Epson OmniLink Merchant Services Development Guide Troubleshooting Problem Check The QR code is not printed as Management Console with the same login ID at the same time. o If you have any trouble with this system, please email us at the following address. North America region: ontact@omnilinkworld. - Epson OmniLink Merchant Services V3 | Development Guide - Page 132
Epson OmniLink Merchant Services Development Guide Appendix Appendix Rights and Available Features OmniLink Merchant Services has 3 user rights. The features available vary by right. Rights The following table describes the three user rights. Type Administrator Technician Developer Target - Epson OmniLink Merchant Services V3 | Development Guide - Page 133
Epson OmniLink Merchant Services Development Guide Appendix Feature Group management/ members Register groups Change group information Change store information Delete stores Batch registration of stores Select services for use Printer information Register printers View printer information - Epson OmniLink Merchant Services V3 | Development Guide - Page 134
Epson OmniLink Merchant Services Development Guide Appendix QR Code Setting Feature Create versions Edit versions View versions Apply versions Contents Print Setting Create versions Edit versions View versions Apply versions Data - Epson OmniLink Merchant Services V3 | Development Guide - Page 135
Epson OmniLink Merchant Services Development Guide Appendix Updating Account Information Changing Email Addresses The email addresses used for signins can be changed. A Access the OmniLink Management Console and sign in. U "Sign - Epson OmniLink Merchant Services V3 | Development Guide - Page 136
Merchant Services Development Guide Appendix D Click Edit next to ID (Email). E Enter a new email address and click Save. F A confirmation email will be sent to the new email address. Log in using the URL described in the email and enable the new email by following the on-screen instructions. 136 - Epson OmniLink Merchant Services V3 | Development Guide - Page 137
Epson OmniLink Merchant Services Development Guide Appendix Changing Passwords This section describes the procedure to change passwords. A Access the OmniLink Management Console and sign in. U "Sign in" on page 11 B Click - Epson OmniLink Merchant Services V3 | Development Guide - Page 138
Epson OmniLink Merchant Services Development Guide Appendix E Configure the following setting items and click Save. Item Old Password New Password New Password (Confirm) Description Enter the old password. Enter the new - Epson OmniLink Merchant Services V3 | Development Guide - Page 139
Epson OmniLink Merchant Services Development Guide Appendix Changing Account Names This section describes the procedure to change your account name. A Access the OmniLink Management Console and sign in. U "Sign in" on - Epson OmniLink Merchant Services V3 | Development Guide - Page 140
Epson OmniLink Merchant Services Development Guide Appendix E Enter the new name and then click Save. 140 - Epson OmniLink Merchant Services V3 | Development Guide - Page 141
Epson OmniLink Merchant Services Development Guide Appendix Deleting Your Account This section describes the procedure to delete your account. A Access the OmniLink Management Console and sign in. U "Sign in" on page - Epson OmniLink Merchant Services V3 | Development Guide - Page 142
Epson OmniLink Merchant Services Development Guide Appendix E Confirm the message and click Delete. 142 - Epson OmniLink Merchant Services V3 | Development Guide - Page 143
Epson OmniLink Merchant Services Development Guide Appendix Viewing Operational Logs of Store/Printer Information This section outlines the procedure to view the operational history of additions, changes, and deletions to store - Epson OmniLink Merchant Services V3 | Development Guide - Page 144
Epson OmniLink Merchant Services Development Guide Appendix E Click Show All. F View the last 14 days of the operations log. a b Description a The last 14 days of operational history regarding store and printer - Epson OmniLink Merchant Services V3 | Development Guide - Page 145
Epson OmniLink Merchant Services Development Guide Appendix Writing Regular Expressions This section describes the regular expressions two types of regular expression description patterns are used with OmniLink Merchant Services. o Pattern 1: Identification of receipts o Pattern 2: Identification of - Epson OmniLink Merchant Services V3 | Development Guide - Page 146
Epson OmniLink Merchant Services Development Guide Appendix Pattern 2: Identification of location of receipt express this as [0-4]{5}. o Multiline mode regular expressions starting with (?m) are not supported. Description Patterns of Regular Expressions by Type of Printer Settings Setting name QR - Epson OmniLink Merchant Services V3 | Development Guide - Page 147
Epson OmniLink Merchant Services Development Guide Appendix Example Regular Expressions Contents Print o Regex pattern to print content Insert coupons between 07:00 and 09:59 only (Pattern 1-1) (?s)^.*0[7-9]:[0-5][0-9].*$ Insert coupons only from - Epson OmniLink Merchant Services V3 | Development Guide - Page 148
Epson OmniLink Merchant Services Development Guide Appendix Operating Environment Supported POS Systems This service can be used for POS systems that use TM-T88VI or TM-T88VI-iHUB printers and satisfy the following conditions. o The content of receipts printed - Epson OmniLink Merchant Services V3 | Development Guide - Page 149
Epson OmniLink Merchant Services Development Guide Appendix o Microsoft Edge o Google Chrome o Mozilla Firefox o Apple Safari 149 - Epson OmniLink Merchant Services V3 | Development Guide - Page 150
Epson OmniLink Merchant Services Development Guide Appendix Open Source Software License The OmniLink Merchant Services use open source software other than software owned by Epson. The following is the information of the open source software. OmniLink Merchant Services The full text of license - Epson OmniLink Merchant Services V3 | Development Guide - Page 151
Epson OmniLink Merchant Services Development Guide Appendix Trademarks EPSON is a registered trademark of Seiko Epson Corporation. EXCEED YOUR VISION is a registered trademark or trademark of Seiko Epson Corporation. OmniLink is a trademark
OmniLink Merchant
Services
Development Guide
M00122600 EN