MERCHANT CONTROL PANEL (INTERNET PAYMENT)

Transcription

1 MERCHANT CONTROL PANEL (INTERNET PAYMENT) Filename: Monetico_Internet_Payment_Merchant_Control_Panel_v4_2_06B Version no.: B Date:

2 Confidential Document title: Monetico Payment Merchant Control Panel Filename: Monetico_Internet_Payment_Merchant_Control_Panel_v4_2_06B Version number: B Date: The Desjardins products and services described in this document are the exclusive property of Desjardins Financial Group and all associated logos and taglines are trademarks of Desjardins Financial Group. All other trademarks mentioned in this document as well as the corresponding copyrights belong to their respective owners. The information provided in this document is confidential and for the exclusive use of Desjardins Group and its partners. Any reproduction or distribution in whole or in part without the written permission of Desjardins Financial Group is strictly prohibited. Web site: All rights reserved Copyright Fédération des caisses Desjardins du Québec Version B 2

3 TABLE OF CONTENTS 1 Introduction Objective Test environment Production environment 5 2 Accessing the Control Panel Access requirements Logging in Logging out 7 3 Control panel overview Navigation menu (A) Information column (B) Activity summary (C) Payment management (D) Configuration ( Parameter ) (E) Help centre (F) Security tools (G) Environment and documentation (H) Description of pictograms 11 4 Payment management Available actions Payment categories Preauthorization awaiting completion Recent payments Recent completions Recent refunds Recent standalone refunds Advanced search Payment details Create telephone / mail order Perform a standalone refund Payment Actions Viewing payments awaiting an action Viewing payment details From the payment reference (order no.) 35 Version B 3

4 From a payments list Exporting the payments list Printing the payments list Completing a payment Partially completing a payment Refunding a payment Cancelling a payment Stopping a recurrent payment Completing multiple payments Partially completing multiple payments Cancelling multiple payments Stopping the recurrence of multiple payments 45 5 Configuration EPT status Summary file Password change Obtaining the security key 52 6 Help centre Complete documentation FAQ 54 7 Security tools Disengageable 3DSecure Overview Payment amount configuration 55 Version B 4

5 1 Introduction 1.1 Objective The purpose of the Control Panel is to enable you to view all the payments made on our payment platform and process the payments awaiting completion. 1.2 Test environment Thanks to this environment, you can become familiar with the use of your Control Panel by learning to process the payments that have been made in your test environment. Of course, no payment validated in this environment will be completed as a real financial transaction. The test environment is available at the following address: This test environment is directly identifiable by the presence of the word TEST in the header band. 1.3 Production environment This is the environment in which you will manage your actual real payments; it is available at the following address: Version B 5

6 2 Accessing the Control Panel 2.1 Access requirements To access your Control Panel for the first time, you must use the user ID and password provided to you by when your contract was signed. Please note that this information was provided to you in two separate s : : In the first , you received your Userid (in «DJD-XXXXXXXX XXX» format) and the first 4 digits of your temporary password (in «nnnn????» format, e.g. «1234????»). In the second , you received your Userid and the last 4 digits of your temporary password (in «????nnnn» format, e.g. «????5678»). Your complete temporary 8-digit password is made up then of the 1st 4 digits from the first and the last 4 digits from the 2 nd (e.g. « »). At your first login to the Merchant control panel (using your temporary password), the system will display the following screen: On this password change screen, you must again enter your complete 8-digit temporary password (e.g. « »). After you enter your new password (twice) and click on CONFIRM, the following screen is displayed: Version B 6

7 Now you must once again identify yourself using your new permanent password by clicking on «identify yourself once again» If you need an additional user ID, you may ask for one from our Support Centre: By By telephone: or If your business has several virtual EPTs, you may apply for your user ID to be able to access the Control Panels of all those virtual EPTs. 2.2 Logging in The Control Panel is available at the following address: If this is the first time that you have logged in to the Merchant control panel, please follow the procedure specified in section 2.1. To log in, you must then enter your user ID and your password on the identification screen. 2.3 Logging out To log out, you must click the Logout link at the top right of all Control Panel screens: After two hours of inactivity, you will automatically be logged out from the Control Panel. Version B 7

8 3 Control panel overview The home page of your Control Panel is made up of several elements: A. Navigation menu: present throughout the Control Panel B. Information column: immediately shows the EPT on which you are working C. Activity summary, with direct links to the most important tools for managing your payments D. Payment management block: point of access to additional payment management tools E. Parameter block: point of access to EPT configuration tools F. Help centre block: links to the different online help G. Security tools block : point of access to 3DSecure disable function H. Information column: shows the environment you are working in, with direct access to the documentation. Version B 8

9 3.1 Navigation menu (A) The main menu, which can be found on all Control Panel screens, allows you to navigate between the different sections of the Control Panel: - Payment management - EPT configuration - Tutorials. 3.2 Information column (B) The EPT selection block on the right-hand side of all Control Panel screens allows you to select the EPT on which you want to work (or on all the EPTs simultaneously). When the EPT selection changes, the current page is automatically refreshed to display the data of the selected EPT. For example, on a screen listing the payments, only the payments of the selected EPT will be displayed; if all the EPTs are selected, the list will contain the payments of all your EPTs. Note that you cannot change EPTs on all screens (e.g. on screens for changing the configuration of an EPT); in that case, the block is greyed out and inaccessible. The Merchant information block displays the name and logo of the merchant for the selected EPT. When no EPT is selected, this block is not displayed. 3.3 Activity summary (C) The activity summary shows your EPT s key activity statistics directly from the Control Panel home page. This data may be displayed as amounts or numbers of payments. For each section displayed, the data elements are presented in three columns: - Today s data - Yesterday s data - Seven days ago s data. It is also possible to display a graph showing the last 8 days trend by clicking on the icon at the beginning of the line. Version B 9

10 By clicking on the link «You have X payments awaiting an action on your part» you are redirected to a page listing the payments upon which you must act. - Number of payments: shows the number of payments performed today, yesterday and a week ago - Number of completions: shows the number of completions performed today, yesterday and a week ago - Number of refunds: shows the number of refunds performed today, yesterday and a week ago - Number of standalone refunds: shows the number of standalone refunds performed today, yesterday and a week ago The same information is accessible in terms of amounts: When no EPT is specifically selected, the summary displays the data for all EPTs listed. When a specific EPT is selected, the summary is refreshed to display the information for the selected EPT. You can directly access the corresponding list of payments, completions, refunds or standalone refunds by clicking on the numbers displayed in the summary. 3.4 Payment management (D) The Payment management section on the home page provides links to additional tools for managing your payments: - Advanced search: search one or more payments using a number of advanced criteria - Create telephone/mail order: this is for creating a telephone / mail order, by directly entering the credit card details provided by the customer Version B 10

11 - Perform standalone refunds For more information about these tools, please refer to the relevant section. 3.5 Configuration ( Parameter ) (E) The Parameter section of the home page provides links to the following Control Panel functions: - Changing the password: - Advanced configuration: access to the EPT configuration screens - EPT status: this link is only available in the test environment and makes it possible to enable or disable the EPT in the test environment 3.6 Help centre (F) The Help Centre section of the home page provides links to the online help functions: - Full documentation: downloading the full Control Panel documentation - FAQs: list of frequently asked questions from Control Panel users 3.7 Security tools (G) The «Security tools» section of the home page provides links to the different security tools including: - Disengageable 3DSecure 3.8 Environment and documentation (H) The Environment block on the right-hand side of all Control Panel screens shows the environment in which you are working (Test or Production). The link provided allows you to switch rapidly from one environment to the other. The Documentation block, which can also be found on all Control Panel screens, provides direct access to Control Panel documentation. 3.9 Description of pictograms As you navigate through the Control Panel screens, you will come across several pictograms, the meanings of which are explained here. Result of action triggered by you, or action is expected from you to continue processing. Tip to allow you to optimize your use of the Control Panel. An error has occurred. Read the text displayed for more information about the error and what steps need to be taken. Version B 11

12 4 Payment management This section combines the functions provided by clicking the «Payment Management» tab (or by using the Activity Summary shortcuts) and the functions provided by clicking on the elements of the Payment Management block of the home page. The payment management functions available via the «Payment Management» tab are presented by payment category (see section 4.2). The «Payment Management» block provides access to these same functions (by clicking Search Payments ) as well as to the following additional functions: - Process phone/mail orders - Perform standalone refunds 4.1 Available actions The Control Panel allows you to view the activity of your different EPTs via predefined screens (payments awaiting completion, recent refunds etc.). It also allows you to act on the recorded payments. Section 4.7 documents the steps required to perform specific actions such as: Complete Complete is used to complete a payment. This may be done individually for a single payment or for several payments simultaneously. The completion is done on the total payment amount. Completion relates to the entire amount of the payment. However, Partially complete may be used to complete a payment in several instalments, and you will be asked to specify the desired amount. Refund The Refund function enables you to refund any portion of the amount of an order that has already been paid, in full or in part. You may make several successive refunds for the same payment, as long as the maximum authorized refund amount is not reached. This function is only available individually for a given payment (no batch processing). Cancel Cancel allows you to cancel a payment that is awaiting completion. This operation is permanent, and a cancelled payment can no longer be completed. This may be done individually for a single payment or for several payments simultaneously. Version B 12

13 Stop recurrence Stop recurrence is only available with recurrent payments, and makes it possible to stop recurring payments in future. Payment occurrences that have already been created are not cancelled. This may be done individually for a single payment, or for several payments simultaneously. 4.2 Payment categories The payment categories are displayed by clicking the «Payment Management» tab Preauthorization awaiting completion Definition This tool allows you to access the list of payments that are awaiting an action on your part. The EPTs concerned are those that are configured for the following types of payment: - Preauthorization: You have 7 working days to process the payment. After that time, action is taken automatically. The action is defined in the configuration of your EPT (automatic cancellation or approval). Version B 13

14 - Recurrent: You have a period up to the recurrence of the payment to process the first payment. After that time, no action is possible with that first payment. Depending on the frequency defined in the configuration of your EPT, a new payment will be created during the period defined by the configuration of your EPT or until the card expires. A payment operation will be required for the new payment if your EPT is configured to not complete it automatically. Only EPTs configured for Purchase payment do not require any action on your part. Data displayed All the payments awaiting processing are shown in a data table. The data in the table depends on the EPT(s) selected. When you display the payments for all your EPTs, the information available is: - EPT number (when the All EPTs option is selected) - Payment reference (order no.) - Payment date and time - Amount In addition to this common information, some payment modes have specific data: - Recurrent o Remaining amount: Amount to be completed from the payment o Occurrence number For each column in the table, click the column header to sort the data on that column. Available actions For each payment appearing in the data table, a list of actions is available (if no payment is found, no action is available). The available actions depend on the payment mode of the selected EPT. If all the EPTs are selected The available actions are: - Download XML CVS: This action link enables you to download the list of payments in the table in XML or CVS format. - Print: This action link enables you to print the list of payments in the table. - See payment details: The link available with the payment reference enables you to view the payment details screen. If a specific preauthorization payment EPT is selected The available actions are: - Download XML CVS: This action link enables you to download the list of payments in the table in XML or CVS format. - Print: This action link enables you to print the list of payments in the table. - See payment details: The link available with the payment reference enables you to view the payment details screen. Version B 14

15 - Complete: This action link enables you to complete several payments in a single operation. You select all the payments you want to complete from the payments in the table. - Cancel: This link enables you to cancel several payments in a single operation. You select all the payments you want to cancel from the payments in the table. If a specific partial payment EPT is selected (Note: This function is not currently offered by Desjardins.) The available actions are: - Download XML CVS: This action link enables you to download the list of payments in the table in XML or CVS format. - Print: This action link enables you to print the list of payments in the table. - See payment details: The link available with the payment reference enables you to view the payment details screen. - Complete: This action link enables you to fully complete several payments in a single operation. You select all the payments you want to complete from the payments in the table. - Partially complete: This action link enables you to partially complete several payments in a single operation. You select all the payments you want to complete from the payments in the table. Then, for each payment, you define the amount you want to complete. The entered amounts can be full completions. - Cancel: This link enables you to cancel several payments in a single operation. You select all the payments you want to cancel from the payments in the table. If a specific recurrent payment EPT is selected The available actions are: - Download XML CVS: This action link enables you to download the list of payments in the table in XML or CVS format. - Print: This action link enables you to print the list of payments in the table. - See payment details: The link available with the payment reference enables you to view the payment details screen. - Complete: This action link enables you to fully complete several payments in a single operation. You select all the payments you want to complete from the payments in the table. - Partially complete: This action link enables you to partially complete several payments in a single operation. You select all the payments you want to complete from the payments in the table. Then, for each payment, you define the amount you want to complete. The entered amounts can be full completions. - Cancel: This link enables you to cancel several payments in a single operation. You select all the payments you want to cancel from the payments in the table. Version B 15

16 - Stop recurrence: This action link allows you to stop the recurrence of several payments. You select all the payments you want to stop from the payments in the table. Applying the actions Download XML CVS See section Exporting the payments list Print See section Printing the payments list Complete See section Completing multiple payments Partially complete See section Partially completing multiple payments Cancel See section Cancelling multiple payments Stop recurrence See section Stopping the recurrence of multiple payments Version B 16

17 4.2.2Recent payments Definition This tool allows you to access the list of payments made during the last 8 days. Data displayed All recent payments (whether or not awaiting action on your part) can be found in a data table. The data in the table is independent of the payment mode of the selected EPT. Thus, when you display payments for a particular EPT or to all your EPTs by selecting All EPTs under EPT selection, the information available is: - EPT number (when the All EPTs option is selected) - Payment reference (order no.) - Payment date and time - Amount - Payment method - Payment status (Completed, Declined, etc.) - Result of the call to the return interface For each column in the table, click the column header to sort the data on that column. Version B 17

18 Available actions For each payment appearing in the data table, a list of actions is available (if no payment is found, no action is available). The available actions are independent of the payment method of the selected EPT. The available actions are: - Download XML CVS: This action link enables you to download the list of payments in the table in XML or CVS format. - Print: This action link enables you to print the list of payments in the table. - See payment details: The link available with the payment reference enables you to view the payment details screen. - View payments of the previous week: The link See from x to x shown at the bottom of the page enables you to navigate from week to week to see the payments of the previous weeks. Applying the actions Download XML CVS See section Exporting the payments list Print See section Printing the payments list Version B 18

19 4.2.3Recent completions Definition This tool allows you to access the list of completions made during the last 7 days. Data displayed All the payments with a completion in the course of the last 7 days are shown in the data table. The data in the table is independent of the payment mode of the selected EPT. Thus, when you display completions for a particular EPT or to all your EPTs by selecting All EPTs under EPT selection, the information available is: - EPT number (when the All EPTs option is selected) - Payment reference (order no.) - Payment date and time - Payment amount - Payment method - Completion amount - Completion date For each column in the table, click the column header to sort the data on that column. Totals table: The recent completions page also displays a second table with the total completions grouped by EPT (when the All EPTs option is selected), host EPT, site code, payment method, payment network and currency. Check boxes are provided to modify the inclusion of columns while grouping so as to be able to adjust the display of totals. Version B 19

20 Note that if the number of recent completions is too large (above 5000), only the 5000 most recent completions are displayed and counted while calculating the totals in the second table. Available actions For each payment appearing in the data table, a list of actions is available (if no payment is found, no action is available). The available actions are independent of the payment mode of the selected EPT. The available actions are: - Download XML CVS: This action link enables you to download the list of payments in the table in XML or CVS format. - Print: This action link enables you to print the list of payments in the table. - See payment details: The link available with the payment reference enables you to view the payment details screen. - View payments of the previous week: The link See from x to x shown below the table enables you to navigate from week to week to see the payments of the previous weeks. Applying the actions Download XML CVS See section Exporting the payments list Print See section 4.7.4Printing the payments list Version B 20

21 4.2.4Recent refunds Definition This tool allows you to access the list of refunds made during the last 8 days. Data displayed All the payments with refunds during the last 8 days are displayed in a data table. The data in the table is independent of the payment mode of the selected EPT. Thus, when you display refunds for a particular EPT or for all your EPTs by selecting All EPTs under EPT selection, the information available is: - EPT number (when the All EPTs option is selected) - Payment reference (order no.) - Payment date and time - Payment amount - Payment method - Amount of refund - Refund date - Refund method (via Control Panel or computerized request) For each column in the table, click the column header to sort the data on that column. Totals table: The recent refunds page also displays a second table with the total refunds grouped by EPT (when the All EPTs option is selected), host EPT, site code, payment method, payment network and currency. Check boxes are provided to modify the inclusion of columns while grouping so as to be able to adjust the display of totals. Version B 21

22 Note that if the number of recent refunds is too large (above 5000), only the 5000 most recent refunds are displayed and counted while calculating the totals in the second table. Available actions For each payment appearing in the data table, a list of actions is available (if no payment is found, no action is available). The available actions are independent of the payment mode of the selected EPT. The available actions are: - Download XML CVS: This action link enables you to download the list of payments in the table in XML or CVS format. - Print: This action link enables you to print the list of payments in the table. - See payment details: The link available with the payment reference enables you to view the payment details screen. - View payments of the previous week: The link See from x to x shown at the bottom of the page enables you to navigate from week to week to see the payments of the previous weeks. Applying the actions Download XML CVS See section Exporting the payments list Print See section Printing the payments list Version B 22

23 4.2.5Recent standalone refunds Definition This tool allows you to access the list of standalone refunds made during the last 8 days. A standalone refund is a standalone refund (i.e. a refund that is not tied to the original purchase). This screen concerns all modes of payment: purchase, preauthorization, partial, split and recurrent. Data displayed All the payments with a standalone refund during the last 8 days are displayed in a data table. The data in the table is independent of the payment mode of the selected EPT. Thus, when you display standalone refunds for a particular EPT or for all your EPTs by selecting All EPTs under EPT selection, the information available is: - EPT number (when the All EPTs option is selected) - Payment reference (order no.) - Standalone refund date and time - Amount - Card expiry date - Standalone refund reason For each column in the table, click the column header to sort the data on that column. Version B 23

24 Available actions For each payment appearing in the data table, a list of actions is available (if no payment is found, no action is available). The available actions are independent of the payment mode of the selected EPT. The available actions are: - Download XML CVS: This action link enables you to download the list of payments in the table in XML or CVS format. - Print: This action link enables you to print the list of payments in the table. - See payment details: The link available with the payment reference enables you to view the payment details screen. - View payments of the previous week: The link See from x to x shown at the bottom of the page enables you to navigate from week to week to see the payments of the previous weeks. Applying the actions Download XML CVS See section Exporting the payments list Print See section Printing the payments list Version B 24

25 4.3 Advanced search Definition This tool makes it possible to search payments on the basis of certain criteria. This screen concerns all modes of payment: purchase, preauthorization, partial, split and recurrent. Search criteria The search criteria are displayed in the form of 3 steps. Version B 25

26 In step 1, you must specify the main search criterion: - Date range If you are searching by date, you can specify if you want to search by: o Purchase date ( payment date) o Completion date o Refund date o Standalone refund receipt date - Payment reference (order no.) If searching by reference, you can enter a complete reference to find a specific payment or enter only the first few characters of a reference to find all the payments whose references begin with those characters. In step 2, you can specify the status of the payment(s) you want to find. All statuses are selected by default. In step 3, you can specify an amount range and a currency matching the payment(s) you want to find. In step 4, you can specify the search output format. Thus, you can decide to directly display the search result on the page (limited to 5000 payments maximum) or choose to receive the result by within a few hours in the form of a CSV file. In the second case, a data entry area will allow you to specify the address to which the file is to be sent. Data displayed The results table shows all the payments matching the entered criteria. The data in the table is independent of the payment mode of the selected EPT. Thus, when you display payments matching a search relating to a particular EPT or to all your EPTs by selecting All EPTs under EPT selection, the information available is: - EPT number (when the All EPTs option is selected) - Payment reference (order no.) - Payment date and time - Amount - Payment status (Paid, Declined, etc.) For each column in the table, click the column header to sort the data on that column. Available actions For each payment appearing in the data table, a list of actions is available (if no payment is found, no action is available). The available actions are independent of the payment mode of the selected EPT. The available actions are: Version B 26

27 - Download XML CVS: This action link enables you to download the list of payments in the table in XML or CVS format. - Print: This action link enables you to print the list of payments in the table. - See payment details: The link available with the payment reference (order no.) enables you to view the payment details screen. Applying the actions Download XML CVS See section Exporting the payments list Print See section Printing the payments list Version B 27

28 4.4 Payment details Definition This screen displays all the detailed information about a payment. Version B 28

29 Data displayed The display is divided into 6 information blocks: - Payment characteristics This is the main block. It displays information about the payment: EPT, reference, date, amount, status, company code (merchant number), etc. This block also contains the action links available. If the «Card Verification Number (CVN)» and «Address Verification System (AVS)» functions are activated for the merchant, the main block contains additional lines as shown below: - List of completions This block lists all the completions that have taken place with the payment. If a refund is authorized, the list of completions offers a Refund action link. This block is not displayed if no completion has been made. - List of standalone refunds This block lists all the standalone refunds that have occurred with the payment. No action is possible for the list of standalone refunds. This block is not displayed if there have been no standalone refunds. - List of refunds This block lists all the refunds that have been made for the payment. No action is possible for the list of refunds. This block is not displayed if no refund has been made. - Fraud prevention information This block provides additional information about the payment: origin of the credit card, origin of the transaction, customer's IP address, etc. This block is only displayed if the anti-fraud option is included in your contract. Available actions The main block lists the actions available for the payment displayed. The actions vary depending on the type of payment (Purchase, Preauthorization etc.) and the payment status (declined, paid, cancelled etc.). If a purchase type payment is displayed When a purchase payment is displayed, the actions available are: Version B 29

30 - Print: This action link enables you to print the details page of the payment displayed. - Refund: This action link is available in the list of completions and enables you to refund all or part of the corresponding completion. This action is not available if the payment has been cancelled or if the completion has already been refunded in full or if the user is not authorized to refund a payment. If a preauthorization payment is displayed When a preauthorization payment is displayed, the actions available are: - Print: This action link enables you to print the details page of the payment displayed. - Complete: This action link enables you to complete the totality of the payment displayed. This action is not available if the payment has already been completed or cancelled. - Cancel: This link enables you to cancel the payment displayed. This action is not available if the payment has already been completed or cancelled. - Refund: This action link is available in the list of completions and enables you to refund all or part of the corresponding completion. This action is not available if the payment has been cancelled or if the completion has already been refunded in full or if the user is not authorized to refund a payment. If a recurrent type payment is displayed When a recurrent payment is displayed, the actions available are: - Print: This action link enables you to print the details page of the payment displayed. - Complete: This action link enables you to complete the totality of the payment displayed. This action is not available if the payment has already been completed or cancelled. - Partially complete: This action link enables you to partially complete the payment displayed. The amount entered may be that of a full completion. This action is not available if the payment has already been completed or cancelled. - Cancel: This link enables you to cancel the payment displayed. This action is not available if the payment has already been completed or cancelled. - Refund: This action link is available in the list of completions and enables you to refund all or part of the corresponding completion. This action is not available if the payment has been cancelled or if the completion has already been refunded in full or if the user is not authorized to refund a payment. - Stop recurrence: This action link allows you to stop the recurrence of the payment displayed. This action is not available if the recurrence has already been stopped. Applying the actions Print Version B 30

31 See section Printing the payments list Complete See section Completing a payment Partially complete See section Partially completing a payment Refund See section Refunding a payment Cancel See section Cancelling a payment Stop recurrence See section Stopping a recurrent payment 4.5 Create telephone / mail order This screen enables you to enter a telephone / mail order. This screen is available for all types of EPT. You must select the EPT on which the order will be created in the EPT selection area. Entry fields are provided to complete the following information: - Site code used (selection from a list of site codes of the EPT) - Payment reference Version B 31

32 - Payment amount and currency - Additional information (free text) The VALIDATE button takes you to the confirmation screen. The confirmation screen contains two buttons, one for finalizing the order created (CONFIRM) and one for going back to the entry page (BACK). After the user confirms the action, they are redirected to the payment page to enter the customer's credit card information. If the «Address Verification System (AVS)» is activated for the merchant, the payment page contains 2 additional input fields: cardholder address and postal code. Version B 32

33 4.6 Perform a standalone refund This function involves a refund that is not tied to an original purchase transaction. Step 1: Select the function From the «Payment management» block on the home screen, click on «Perform a standalone refund». The following screen is displayed: Version B 33

34 Step 2: Enter the standalone refund amount. To continue, enter the requested data, and then click «Validate». Click on «Cancel» to return to the home screen. Step 3: Standalone refund confirmation The confirmation page summarizes the action that will be performed. Click «Confirm» to validate the refund. Click «Cancel» to return to the home screen. 4.7 Payment Actions This section documents the steps required to take specific actions on payments Viewing payments awaiting an action Step 1: Access the page with payments awaiting an action From the home page, in the Activity summary table, click the number of payments awaiting validation. Version B 34

35 The page with payments awaiting an action will be displayed. It shows the list of payments awaiting an action for all the available EPTs. No action (completion, cancellation etc.) is available for now. Step 2: EPT selection In the EPT selection block, select the EPT that you want to view. The page will be refreshed, and the list of payments awaiting an action for that EPT will be displayed. When a particular EPT is selected, the action links are displayed in the table of payments awaiting an action. The actions available vary according to the type of EPT selected. For a purchase payment EPT, there cannot be any payments awaiting an action Viewing payment details From the payment reference (order no.) Step 1: Display the payment search page Version B 35

36 MERCHANT CONTROL PANEL GUIDE From the home page, click the Payment management tab or the Advanced search link in the Payment management section. Step 2: Enter the reference On the search screen, enter the payment reference (order no.) and click the Search button. Step 3: Click the reference link The list of references matching your search is displayed in a table. To obtain the details of the reference, click the link. Version B 36

37 MERCHANT CONTROL PANEL GUIDE From a payments list Step 1: Access a payments list From the home page, in the activity summary table, click the link for the payments list to display. The lists of payments available are: o Payments awaiting an action, o Payments, o Completions, o Refunds, o Standalone refunds. Version B 37

38 MERCHANT CONTROL PANEL GUIDE Step 2: Click the desired reference link The list of payments matching your selection is displayed in a table. To obtain the details of a reference, click the desired link Exporting the payments list Step 1: Download request From the payments list, click the action link for the required format (XML or CVS). The download window will open. Step 2: Open/Save file Click the button that matches your selection (Open or Save). Then click VALIDATE to carry out the action or Cancel to cancel. Version B 38

39 MERCHANT CONTROL PANEL GUIDE Printing the payments list Step 1: Print request From the payments list, click the Print action link. The print window will open. Step 2: Print configuration Select the printer and the print configuration, and then click Print to carry out the action or Cancel to cancel it Completing a payment Step 1: Action selection From the payment details screen, click the Complete link. Step 2: Completion confirmation The confirmation page summarizes the action to be carried out, by specifying the reference, the payment date and amount, and also the completion amount. Click CONFIRM to validate the payment completion. Click Cancel to go back to the payment details. Version B 39

40 MERCHANT CONTROL PANEL GUIDE If you confirm the completion, the application will go back to the payment details and display a message indicating successful completion. The completion will then be displayed in the completions list Partially completing a payment Note that partial completion is only available with partial or recurrent payments. Step 1: Action selection From the payment details screen, click the Partially complete link. Step 2: Enter the completion amount The data entry page allows you to specify the completion amount. To continue, enter the completion amount, then click VALIDATE. Click Cancel to go back to the payment details. Step 3: Confirm partial completion The confirmation page summarizes the action that will be carried out, by specifying the reference, the payment date and amount, and also the completion amount. Click CONFIRM to approve the payment completion. Click Cancel to go back to the payment details. If you confirm the completion, the application will go back to the payment details and display a message indicating successful completion. The completion will then be displayed in the completions list Refunding a payment Note that the refund action is offered individually for each finalized completion. Thus, the action link is shown in the completions table, and not in the main block of the payment details screen. Step 1: Action selection From the payment details screen, click the Refund link of the completion to refund. Step 2: Enter the refund amount Version B 40

41 MERCHANT CONTROL PANEL GUIDE The entry page makes it possible to make a full refund or to specify the refund amount. It also indicates the maximum refund amount authorized. To continue, enter the refund amount and then click VALIDATE. Click Cancel to go back to the payment details. Step 3: Confirm the refund The confirmation page summarizes the action that will be carried out, specifying the payment reference (order no.) and date, and also the refund amount. Click VALIDATE to approve the refund. Click Cancel to go back to the payment details. If you confirm the refund, the application will go back to the payment details and display a message indicating that the refund was successful. The refund made will be displayed in the list of payment refunds Cancelling a payment Step 1: Action selection From the payment details screen, click the Cancel button. Version B 41

42 MERCHANT CONTROL PANEL GUIDE Step 2: Confirm the cancellation The confirmation page specifies that the cancellation of a payment is permanent and that the action must be confirmed. Click VALIDATE to confirm the payment cancellation. Click Cancel to go back to the payment details. If you confirm the cancellation, the application will go back to the payment details and display a message indicating that the cancellation was successful. After the cancellation, no action other than printing will be available for the payment Stopping a recurrent payment Note that recurrence cancellation is only available with recurrent payments where recurrence is 'active'. Step 1: Action selection From the payment details screen, click the Stop recurrence button. Step 2: Confirm recurrence cancellation The confirmation page specifies that if recurrence is cancelled, no further occurrence of the payment will be created. Click VALIDATE to approve the cancellation of the recurrence of the payment. Click Cancel to go back to the payment details. If you confirm the cancellation, the application will go back to the payment details and display a message indicating that recurrence has been stopped Completing multiple payments Step 1: Action selection From the list of payments awaiting an action, click the Complete button. Version B 42

43 MERCHANT CONTROL PANEL GUIDE Step 2: Select the payments In the left-hand column, check the payments awaiting completion. You may select the payments individually or all at once by checking the box Select all. NB: the Select all box only selects the payments displayed on the current page. To select all the payments awaiting an action, this operation must be repeated for each page. Then click Next to go to the confirmation screen or Cancel to go back to the list of payments awaiting an action. NB: the selection will be lost if you go back. Step 3: Confirm the selection This page summarizes the action that will be taken, by displaying the previously selected payments. Click VALIDATE to approve the completion of these payments. Click Back to go back to the payment selection step. Click Cancel to go back to the list of payments awaiting an action. Step 4: Summary of the request This page displays the result of each completion request in the Action result column. The Back button will take you back to the list of payments awaiting an action Partially completing multiple payments Note that partial completion is only available when a partial or recurrent type of EPT has been selected. Step 1: Action selection From the list of payments awaiting an action, click the Partially complete button. Step 2: Select the payments In the left-hand column, check the payments to complete. You may select the payments individually or all at once by checking the box Select all. NB: the Version B 43

44 MERCHANT CONTROL PANEL GUIDE Select all box only selects the payments displayed on the current page. To select all the payments awaiting an action, this operation must be repeated for each page. Then click Next to go to the confirmation screen or Cancel to go back to the list of payments awaiting an action. NB: the selection will be lost if you go back. Step 3: Enter the completion amount This entry page enables you to specify the completion amount for the previously selected payments. Click Next to approve the amounts entered. Click Back to go back to the payment selection step. Click Cancel to go back to the list of payments awaiting an action. Step 4: Confirm the selection This page summarizes the previously selected payments and the completion amounts entered. Click VALIDATE to confirm the completion of these payments. Click Back to go back to the amount entry step. Click Cancel to go back to the list of payments awaiting an action. Step 5: Request summary This page displays the result of each completion request in the Action result column. The Back button will take you back to the list of payments awaiting an action Cancelling multiple payments Step 1: Action selection From the list of preauthorizations to be completed, click the Cancel button. Step 2: Select the payments In the left-hand column, check the payments to cancel. You may select the payments individually or all at once by checking the box Select all. NB: the Select all box only selects the payments displayed on the current page. To select all the payments awaiting an action, this operation must be repeated for each page. Then click Next to go to the confirmation screen or Cancel to go back to the list of payments awaiting an action. NB: the selection will be lost if you go back. Step 3: Confirm the selection This page displays all the previously selected payments. Click VALIDATE to approve the cancellation of these payments. Click Back to go back to the payment selection step. Click Cancel to go back to the list of payments awaiting an action. Version B 44

45 MERCHANT CONTROL PANEL GUIDE Step 4: Request summary This page displays the result of each request for cancellation in the Action result column. The Back button will take you back to the list of payments awaiting an action Stopping the recurrence of multiple payments Note that recurrence cancellation is only available when a recurrent type EPT has been selected. Furthermore, when the action is selected, the selection screen only includes payments where recurrence is 'active'. Step 1: Action selection From the list of payments awaiting an action, click the Stop recurrence button. Step 2: Select the payments In the left-hand column, check the payments to stop. You may select the payments individually or all at once by checking the box Select all. NB: the Select all box only selects the payments displayed on the current page. To select all the payments awaiting an action, this operation must be repeated for each page. Then click Next to go to the confirmation screen or Cancel to go back to the list of payments awaiting an action. NB: the selection will be lost if you go back. Step 3: Confirm the selection This page displays all the previously selected payments. Click VALIDATE to confirm the cancellation of these payments. Click Back to go back to the payment selection step. Click Cancel to go back to the list of payments awaiting an action. Step 4: Request summary This page displays the result of each cancellation request in the Action result column. The Back button will take you back to the list of payments awaiting an action. Version B 45

46 MERCHANT CONTROL PANEL GUIDE 5 Configuration The Configuration (SETTINGS ) section is available from the home page using the navigation menu of the Control Panel (A). Some shortcuts in area (E) provide direct access to the most commonly used functions. 5.1 EPT status Definition This configuration page makes it possible to view and edit the status (Open until a certain date / Closed since a certain date) of an EPT (an EPT needs to be selected under EPT selection ). Note that this configuration is only available in the test environment in order to allow the test EPTs to be closed/opened. By default, upon signing of your contract, an EPT is open for 15 days in the test environment. Data displayed When an EPT is selected under EPT selection, the screen displays the current status (Open until / Closed since) of that EPT. Available actions An Edit ( Amend ) action link is available for editing the status of the selected EPT. Applying the actions Changing the status of an EPT Step 1: Click the Edit ( Modify ) action link The status editing screen is displayed. Information is displayed to explain the principle of being open for a certain period of time. Two options are available: Close / Open for [X] day(s) Version B 46

47 MERCHANT CONTROL PANEL GUIDE Two buttons are available, VALIDATE and CANCEL. Step 2: Validate the modification Select the required status, then click VALIDATE. To cancel the modification and go back to the display screen, click Cancel. Step 3: Confirm the modification The screen for confirming the modification is displayed. Three buttons are available, CONFIRM, Back and Cancel. To complete the modification process, click CONFIRM. To go back to the previous screen, click Back. To cancel the modification and go back to the display screen, click CANCEL. If you confirm the modification, the application will go back to the display screen and display a message indicating that the modification has been successful. Version B 47

48 MERCHANT CONTROL PANEL GUIDE 5.2 Summary file Definition This page makes it possible to view and edit the parameter for sending the summary file (an EPT needs to be selected under EPT selection ). Data displayed When an EPT is selected under EPT selection, the screen displays the current configuration of the EPT summary file. The different information available is: - Status (enabled/disabled) - Sending frequency (daily, every Monday etc.) - List of statuses requested (recorded, declined, paid etc.) - File format (XML or CSV) - Sending method ( or FTP) - FTP information (only if the sending method is FTP) - Notification addresses (maximum of 4) The display varies depending on the EPT and the summary file versions. FTP data are only displayed if the FTP transmission mode has been selected. The sending frequency and the statuses requested are only displayed in the last version of the summary file. Version B 48

49 MERCHANT CONTROL PANEL GUIDE Available actions An Edit ( Amend ) action link is available for editing the configuration of the summary file for the selected EPT. From the TEST environment, a Simulate sending tool action link is available to test sending in order validate the configuration. For EPTs with the latest version of the summary file, a Send back summary file action link is available for sending back a summary file. Applying the actions Modifying the summary file configuration Step 1: Click the Modify action link The modification screen is displayed. Data entry fields are available for modifying or entering the various parameters. Two buttons are available, VALIDATE and Cancel. Step 2: Validate the modification Enter the configuration information for the summary file, then click VALIDATE. To cancel the modification and go back to the display screen, click Cancel. Step 3: Confirm the modification The screen for confirming the modification is displayed. Version B 49

50 MERCHANT CONTROL PANEL GUIDE It shows the configuration of the summary file as it will be saved. Three buttons are available, CONFIRM, Back and Cancel. To complete the modification process, click VALIDATE. To go back to the previous screen, click Back. To cancel the modification and go back to the display screen, click Cancel. If you confirm the modification, the application will go back to the display screen and display a message indicating that the modification was successful. Simulating the sending of the summary file Step 1: Click the Simulate sending tool action link The screen for simulating the sending of the summary file is displayed. Two buttons are available, VALIDATE and Cancel. Version B 50

51 MERCHANT CONTROL PANEL GUIDE To simulate the sending of the file, click VALIDATE. To cancel the simulation and go back to the display screen, click Cancel. Step 2: Validate the simulation of sending the summary file Click VALIDATE to run the simulation. Depending on the current configuration of the summary file, either an is sent to the specified address or a test file is placed on the FTP server. The application goes back to the display screen and displays a message indicating that the simulation has been completed successfully. Asking for the return of a summary file Step 1: Click the Return summary file action link The entry screen for a return request is displayed. Data entry fields are provided for specifying the relevant period (day, week or month). Two buttons are available, VALIDATE and Cancel. Step 2: Validate the return request Enter the period for which you want to receive the payments summary file, then click VALIDATE. To cancel the entry and go back to the display screen, click Cancel. Step 3: Confirm the return request The confirmation screen for the return request is displayed. This screen summarizes the request entered earlier. Three buttons are available, VALIDATE, Back and Cancel. To complete the summary file return process, click VALIDATE. To go back to the previous screen, click Back. To cancel the modification and go back to the display screen, click Cancel. If the request is confirmed, the summary file return request is saved and the application goes back to the viewing screen. The file is sent back to you within a few hours. Version B 51

52 MERCHANT CONTROL PANEL GUIDE 5.3 Password change Definition This page makes it possible to change the password for accessing the Control Panel. Applying the actions Changing your password Step 1: Change your password Enter your current password, and then enter your new password twice. Click CONFIRM. The application displays a message indicating that the change was successful, and asks the user to log in once again for access to the Control Panel Step 2: Log into the Control Panel once again Click the Log in again link to go back to the identification page. Log in to the Control Panel with your user ID and new password. 5.4 Obtaining the security key Definition This page allows you to download your security key so that you can calculate the HMAC seal to certify the data sent to the payment solution (refer to the Integration Guide). Version B 52

53 MERCHANT CONTROL PANEL GUIDE Data displayed When an EPT is selected under EPT selection, the screen displays all technical contacts associated with the EPT. Applying the actions Obtaining the security key Step 1: Select the technical contacts All your technical contacts are displayed. You must select those contacts who are to receive the security code that allows for downloading of the key. Click VALIDATE. Step 2: Enter the confirmation code An is sent to each of the selected contacts. The code contained in the is valid for two hours. The code must be entered in the field provided, then click VALIDATE. To cancel the request and return to the Control Panel s home page, click Cancel. Version B 53

54 MERCHANT CONTROL PANEL GUIDE Step 3: Obtain the security key You can download the key file. To complete the process, click the VALIDATE button. 6 Help centre 6.1 Complete documentation Complete documentation includes a description of all the screens and functions of the Control Panel. The present document provides that information. 6.2 FAQ The FAQ is available by clicking «FAQ» in the «Help Centre» block of the Merchant control panel home screen. Version B 54

55 MERCHANT CONTROL PANEL GUIDE 7 Security tools Disengageable 3DSecure 7.1 Overview The disengageable 3DSecure option when activated on an EPT allows bypassing the 3DSecure authentication steps for a given transaction. This option is accessible to EPTs only in version 3.0. The disengagement function can be achieved in different ways: 1. According to the payment amount 2. Upon criteria determined beforehand (the details of this method are presented in the Integration Guide.) The amount is configured via the Merchant Control Panel. Once this configuration is activated, all payments for which the amount is less than or equal to the configured amount will bypass the 3DSecure authentication steps. 7.2 Payment amount configuration To implement this configuration, you must first logon to the Control Panel at the following URL: The configuration will be effective for all your payments on the selected EPT as soon as the amount is validated on the confirmation screen. On the Control Panel home page, click on «3DSecure disable function» under «Security tools» If you have multiple EPTs, select the EPT for which the amount limit is to apply. If this parameter has not yet been configured, click «Add configuration». Otherwise, the following screen will be displayed. To modify the configuration, click «Edit configuration». Version B 55

56 MERCHANT CONTROL PANEL GUIDE Enter the amount below which 3DSecure will be deactivated. Verify that the status is set to «Activated». Then validate this configuration. A final confirmation screen shows the data entered and requests a final validation. Version B 56