Magento 2 Plugin Integration Guide
Online payment solutionsfor Asia-PacificMagento 2 Plugin IntegrationGuide
Magento 2 Plugin Integration GuideTable of ContentsOverview . 3Related Documents . 3Requirements . 3Installation . 4Configuration . 6Firewall Configuration . 7Merchant Firewall Rules/White-listing - Payment Gateway Outgoing . 7Merchant Firewall Rules/White-listing - Payment Gateway IP Addresses . 7Notifications . 8Magento Notifications . 8Viewing Notifications / Debugging Notification Issues . 8Order States & Events . 10Performing Transactions . 11Capturing Transactions . 11To issue a settlement from within Magento: . 11Voiding Transactions . 13To void a transaction within Magento: . 13Crediting Transactions . 14To issue a credit transaction within Magento: . 14Viewing Transaction Details . 15To view transactions within Magento . 15Troubleshooting . 17Change Log . 18 Copyright Protected. All rights reserved.Published on 2017-11-30.Page 2 of 18
Magento 2 Plugin Integration GuideOverviewThis document describes how to enable the Magento 2.0 Plugin (supports versions 2.0 / 2.1 / 2.2 ofMagento) for use with the Gateway-Hosted Payment Page. The Magento plugin provides the followingcapabilities: Allow Magento to redirect customers to the Gateway-Hosted Payment Page. Allow Magento to perform actions on existing orders such as crediting or settling an Authorisationtransaction. Allow event notifications from the Payment Gateway to be consumed and displayed within Magento.Related DocumentsRelated Documents are available from the Payment Gateway at https://my.ipgpay.com/support/docs.Alternatively log into the Payment Gateway and from the top navigation menu click Support, thenDocument Downloads.DocumentDescriptionSecure PaymentForm APIGateway-Hosted Payment Page - a PCI DSS compliant payment form that allowsmerchant's to process payments securely for a variety of supported payment methods.This document provides technical information on the Application-Programming Interface(API) for merchant's to complete their integration.Web ServicesAPIThis document covers the technical specifications of the Web Services API that includesinformation on ancillary and reconciliation services. This API is used for submittingcustomer and order information along with the tokenised card data.User Guide forManagersThis user guide provides information on the tools a manager can use on the Gatewayincluding: Reviewing and managing configuration Managing payment forms including creating new forms or addition of new fields, oradvanced customisation of existing forms Managing notifications, including notification endpoints and configuration Managing predefined items Managing passwords & password realms Managing integration errors Managing/searching existing ordersRequirementsTo use the Magento plugin, the folllowing items are required: A working and properly configured Magento installation A valid Payment Gateway merchant account Payment Form URL, Secret Key, Manager Account ID, API Key and API Base URL provided by youraccount manager. A Payment Form ID from a Payment Form created in the Payment Gateway. A notification URL that points to your Magento installation configured in the Payment Gateway. Copyright Protected. All rights reserved.Published on 2017-11-30.Page 3 of 18
Magento 2 Plugin Integration GuideInstallationCUSTOMISED TEMPLATESThe plugin has been designed for the default Magento template and it is not possibleto support all available customized skins. If there are compatibility issues with acustomized template we recommend contacting the supplier of the template.To install and configure the Magento plugin:1.Installation of the IPGPAY Payment Method requires the command line interface for Magento 2.For more information about the command line, please see the official Magento n the command line prompt, execute the following in your Magento folder:# Update composer (this will take a while) composer update# Install the IPGPAY magento payment module composer require ipgpay/ipgpay-magento2-payment-module# Enable the module magento module:enable IPGPAY IPGPAYMagento2The following modules have been enabled:- IPGPAY IPGPAYMagento2# Run the scripts and clear the cache after installing new modules magento setup:upgrade magento cache:flush3.If installed correctly, the payment module should be visible in Stores - Configuration - Sales - Payment Methods.4.Ensure module is active - Enabled Yes.5.Configure the module with values supplied by your account manager Copyright Protected. All rights reserved.Published on 2017-11-30.Page 4 of 18
Magento 2 Plugin Integration Guide Copyright Protected. All rights reserved.Published on 2017-11-30.Page 5 of 18
Magento 2 Plugin Integration GuideConfigurationThe following configuration options are available in the Magento plugin:OptionDescriptionEnabledEnable or disable the Magento plugin.TitleThe title displayed to the customer on the store front during checkout.Payment Form URLGateway-Hosted Payment Page URL assigned by your account manager.Payment Form IDID of the Payment Form created in the Payment Gateway.Secret KeySecret key used in forming requests to the Gateway-Hosted Payment Page, andused to verify notifications from the Payment Gateway.Request ExpiryTime period validity of requests to the Gateway-Hosted Payment Page. Used toensure that product prices or specials are only accepted on the Gateway-HostedPayment Page for the specified time period.Account IDYour assigned Manager ID within the Payment Gateway.API keyKey to access the Web Services API.API Base URLBase URL of the Payment Gateway.Test ModeCheckout in Liveor Testmode. Live mode will perform financial transactions. Testmode will perform non-financial transactions for the purpose of testing.New Order StatusThe initial state of orders before payment has been completed by the customer.Create CustomerEntitiesWill create a customer entity for each order.Merchant ManagedRebillingWill create orders capable of Merchant Managed rebilling via the Web ServicesAPI.Payment FormApplicable CountriesActivate specific countries or all countries during checkout.Payment Form SpecificCountriesCountries available during the checkout.Use PopupWill use popup when payment order Yes: Open a popup window to payment No: Redirect to IPG Gateway to payment Copyright Protected. All rights reserved.Published on 2017-11-30.Page 6 of 18
Magento 2 Plugin Integration GuideFirewall ConfigurationMerchant Firewall Rules/White-listing - Payment GatewayOutgoingIn order to connect to the Payment Gateway to issue settlements or credits you must ensure that youhave added the required rules or white-listing to your firewall or servers to allow outgoing connectionstohttps://my.ipgpay.com in your firewall.IMPORTANTThis rule cannot be done with IP addresses as they can change at any time.Merchant Firewall Rules/White-listing - Payment Gateway IPAddressesIn order to receive notifications from the Payment Gateway you must ensure that you have added therequired rules or white-listing to your firewall or servers to allow connections from the following IPaddresses:217.119.96.3 217.119.96.4 217.119.98.3 217.119.98.4It is important that all the above IP addresses are white-listed in your system, otherwise notificationsmay fail. Copyright Protected. All rights reserved.Published on 2017-11-30.Page 7 of 18
Magento 2 Plugin Integration GuideNotificationsNotifications are server to server messages sent from the Payment Gateway to a Merchant or ThirdParty system endpoint, providing details on an event that happened on the Payment Gateway. Thisallows Merchants to integrate their website or application tightly with the Payment Gateway and toperform actions on their own system in response to events.The Merchant must create their own script/application on their server and provide the URL to theirAccount Manager to be configured in their Merchant Configuration, events will then be sent to this URL.Types of notification events include: New Payment Orders. Payment Completion (for Payment Methods where the payment is asynchronous). Fraud advice received for previous Orders/Transactions.Please refer below for a full list of supported notification events.Magento NotificationsIn order for the Payment Gateway to send these notifications you need to provide your accountmanager with the endpoint of your Magento installation.For example - if you have installed your Magento instance on a domain https://www.example.com inthe root ( / ) directory - your notification endpoint would dleFor merchants running a multilingual Magento installation, the URL would ation/handleYou will need to confirm this on your own environment to ensure the URL is correct.The URL must be a fully qualified host/domain name - IP Addresses are not supported. Notificationscan only be sent to port 80 or 443 (http:// or https://). It is highly recommended that merchants use anSSL secured endpoint (https://) for notifications.Viewing Notifications / Debugging Notification IssuesIf you are having issues receiving notifications the Payment Gateway has tools to help you view thenotification data, response to the notification request and also to trigger a notification to be resent.The first thing you should verify is that the Payment Gateway IP addresses have been successfullyadded to your firewall/system. Double check your firewall/system logs to ensure the notifications are notbeing blocked/dropped.To view notifications log into the Payment Gateway and from the top navigation menu clickeCommerce, then Notifications. You will be able to view/search for notifications that have beenattempted by the Payment Gateway. The status and type of notification are displayed, along with thefirst and last time the notification was attempted.To retry the notification - click the Resend button. The Payment Gateway will then attempt to send thenotification again. Copyright Protected. All rights reserved.Published on 2017-11-30.Page 8 of 18
Magento 2 Plugin Integration GuideTo view the raw request data for a notification click the Notification ID - you can then see the endpointURL used - and the HTTP response code returned by the endpoint. If you click request details you cansee the raw and tabular data sent to the endpoint. Copyright Protected. All rights reserved.Published on 2017-11-30.Page 9 of 18
Magento 2 Plugin Integration GuideOrder States & EventsEventOrder StateInformationCustomer confirms order andredirected to the GatewayHosted Payment PagePendingAwaiting customer to complete payment.Customer completed order andreturns to cart / Paymentnotification receivedAuth: PendingPaymentPayment has been received. Authorisationtransactions will still require settlement usingCapture functionality within Magento admin.Sale: ProcessingSale transactions will automatically createInvoices.Invoice created within Magentowith Capture Online optionProcessingPayment will be automatically settled in thePayment Gateway. It settlement fails, the invoicewill not be created. Order will be indicated as paid.Void issued from withinMagentoProcessingPayment will be automatically voided in thePayment Gateway.Credit memo issued fromwithin MagentoProcessingPayment will be automatically credited in thePayment Gateway.Rebilling cancelled from withinMagentoNot ApplicableCancelling rebilling is not associated with an orderstatus.Settlement issued from thePayment GatewayProcessingIf an Authorisation transaction is settled from thePayment Gateway, an invoice within Magentoadmin is created automatically.Void issued from the PaymentGatewayCancelledOrders will be cancelled if voided from thePayment Gateway.Credit issued from thePayment GatewayNo changeCredits issued form the Payment Gateway do notchange the order status in Magento.Rebilling instalment issuedfrom the Payment GatewayNot ApplicableRecurring transactions are not associated with anorder status. Copyright Protected. All rights reserved.Published on 2017-11-30.Page 10 of 18
Magento 2 Plugin Integration GuidePerforming TransactionsCapturing TransactionsAuthorisation transactions require settlement before the funds will be cleared. It is recommended thatsettlements are issued when the goods are shipped. The settlements can be issued from withinMagento, or from within the Payment Gateway via the Order Management page. Settlements are onlypossible on transactions that have not previously been settled or voided. To issue a Settlement fromwithin the Payment Gateway, please refer to the User Guide for Managers.To issue a settlement from within Magento: Login to the Magento admin. Go to Sales - Orders. Locate and click the relevant order. Click the Invoice button at the top of the order. Ensure that Capture Online is selected at the bottom of the Invoice Copyright Protected. All rights reserved.Published on 2017-11-30.Page 11 of 18
Magento 2 Plugin Integration Guide Click Submit Invoice. If the settlement is successful, an invoice will be created. Copyright Protected. All rights reserved.Published on 2017-11-30.Page 12 of 18
Magento 2 Plugin Integration Guide Transaction information will also be attached to the order commentsVoiding TransactionsCancelling an Authorisation transaction is possible by issuing a Void. A Void will return funds to the cardholder by cancelling the transaction. Voids are only possible on Authorisation transactions that have notbeen previously settled or voided. Voids can be issued from within Magento or from within the PaymentGateway via the Order Management page. To issue Voids from within the Payment Gateway, pleaserefer to the User Guide for Managers.To void a transaction within Magento: Login to the Magento admin. Go to Sales - Orders. Locate and click the relevant order. Click the Void button at the top of the order. When prompted, confirm the Void request If successful, the transaction will be confirmed Transaction information will be stored against the order comments Copyright Protected. All rights reserved.Published on 2017-11-30.Page 13 of 18
Magento 2 Plugin Integration GuideCrediting TransactionsCredit transactions can be issued from the Credit Memo workflow within Magento or from within thePayment Gateway from the Order Management page. Credits can only be issued on Sale transactionsor Authorisation transactions that have been settled and have an invoice attached.To issue a credit transaction within Magento: Login to te Magento admin. Go to Sales - Orders. Locate and click the relevant order. Locate the relevant invoice you wish to credit. Note: Online credits can only be issued from theinvoice page in Magento, and not from the Order page. Select the invoice, and enter the invoice page by clicking View. Click the Credit Memo button at the top of the Invoice. Copyright Protected. All rights reserved.Published on 2017-11-30.Page 14 of 18
Magento 2 Plugin Integration Guide Click the Refund button at the bottom of the page. If successful, the transaction will be confirmed and the credit memo issued The transaction will be stored in the order historyViewing Transaction DetailsIndividual transaction information is stored within Magento and linked to the relevant order. Detailedinformation about each transaction is viewable from the Transaction Management page and from theorder page.To view transactions within Magento Login to the Magento admin. Go to Sales - Transactions. Locate and click the relevant transaction Copyright Protected. All rights reserved.Published on 2017-11-30.Page 15 of 18
Magento 2 Plugin Integration Guide Copyright Protected. All rights reserved.Published on 2017-11-30.Page 16 of 18
Magento 2 Plugin Integration GuideTroubleshootingSymptomIPGPAY payment option doesnot appear on the Magentofront endResolution Ensure files are copied to the correct location Clear Magento cache Run ./bin/magento module:enable --clear-static-contentIPGPAY Gateway Ensure Enabled Yes in the plugin configurationMagento workflow does nottrigger/Orders do not changestatus Ensure that the Notification URL is correctly configured in yourGateway account configuration Ensure you do not have firewalls blocking notifications from theGateway Ensure the secret key is correctly configured and matches yourGateway account configurationCapture/Void from withinMagento does not work Ensure API key is correctly configured"Data tempering detected"error message shown whenloading the Payment Form Ensure the secret key is correctly configured and matches yourGateway account configuration Ensure firewall is configured to allow outbound connections to PaymentGateway IP Addresses listed above Copyright Protected. All rights reserved.Published on 2017-11-30.Page 17 of 18
Magento 2 Plugin Integration GuideChange LogThe last 10 change events are shown below.DateComment2017-11-30Add Composer installation instructions2017-09-27Add Pop-Up payment form reference2016-10-12Documentation: Updated formatting and added to the Document Downloads section in the PaymentGateway. Added Notifications information on configuring and debugging notification events.2016-10-08Initial Draft Copyright Protected. All rights reserved.Published on 2017-11-30.Page 18 of 18
Magento) for use with the Gateway-Hosted Payment Page. The Magento plugin provides the following capabilities: Allow Magento to redirect customers to the Gateway-Hosted Payment Page. Allow Magento to perform actions on existing orders such as crediting or settling an Authorisation transaction.
Magento 2 Worldpay for Business User Guide by Meetanshi Author: Meetanshi Keywords: Magento 2 Worldpay Payment, Magento 2 Worldpay Payment Gateway Integration, Magento 2 Worldpay Payment Module, Magento 2 Extension, Magento 2, magento 2 worldpay for business, magento 2 worldpay business, worldpay business module for magento 2 Created Date
magento survey magento feedback extension magento survey extension magento feedback magento feedback form magento quiz magento poll extension magento customer feedback magento customer feedback extension magento feedback
A. Create a new Magento instance using composer create-project B. Clone the magento/magento2 GitHub repository C. Run php bin/magento setup:migrate path-to-m1-installation new-version Magento Magento 2 Certified Associate Developer https://www.certification-questions.com
Magento and vice versa. - Our Integration covers 3 modules. We can further customize the Integration service to add up more Modules. Customer Product Order - Our Integration includes: We have developed Custom Magento Plugin, which needs to be installed in your Magento copy to use in integration process.
abrt-plugin-bugzilla x abrt-plugin-filetransfer x abrt-plugin-logger x abrt-plugin-mailx x abrt-plugin-reportuploader x abrt-plugin-runapp x abrt-plugin-sosreport x abrt-python x x abrt-tui x x x abyssinica-fonts x . 3 Oracle Linux and Oracle VM Included .
This is the Magento Soap/xml-RPC user that CSM should authenticate its API Calls with. See below example Magento screen shot. This user should be assigned a Magento user roll that gives it access to all API’s. Use the Soap/xml-RPC User you setup on Magento API Key This is the Magento S
recommended that you consider upgrading your Magento 1 environment to Magento 2. For more information on the differences between Magento 1 and Magento 2 , please see . here. CSM Initial Setup Manage the Magento for CSM Extension CSM requires a setting to allow it to initiate communication to Mage
criminal case process; the philosophies and alterna-tive methods of corrections; the nature and processes of treating the juvenile offender; the causes of crime; and the role of government and citizens in finding solutions to America’s crime problems. 2. Develop, state, and defend positions on key issues facing the criminal justice system, including the treatment of victims, police-community .
