CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release...

96
CyberSource Global Payment Management for Magento 2 User’s Guide Version 3.1.0 Oct 07, 2019

Transcript of CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release...

Page 1: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

CyberSource Global PaymentManagement for Magento 2Userrsquos Guide

Version 310

Oct 07 2019

Table of Contents

1 Introduction 211 Payment Tokenization with Secure Acceptance 212 Credit Card Services 213 Decision Manager 314 Account Takeover Protection 315 Payer Authentication (3-D Secure) 316 PayPal Express Checkout 417 Electronic Check (eCheck) 418 Online Bank Transfers 519 Tax Calculation 6110 Delivery Address Verification 6111 PayPal Credit 6112 Visa Checkout 6113 Klarna 6

2 CyberSource Configuration 721 Secure Acceptance Configuration 722 Decision Manager 1823 Security Credentials 2024 Backend Setup 24

3 Magento Backend Configuration Settings 2531 General Settings 2732 SOAP Web Services Settings 3133 E-Check 3234 Secure Acceptance WebMobile 3635 Token Management Service 3736 3D Secure 20 3837 Delivery Address Verification Service 3938 Klarna 4039 Secure Acceptance Silent Order Post (SOP) 42310 PayPal Express Checkout 43311 Device Fingerprint 45312 Bank Transfer 46313 Visa Checkout 56314 Apple Pay 57315 Account Updater 67

i

316 Taxes 69317 Transactional Emails 75318 Cron Settings 75

4 Payment UX 7641 Using Iframe Mode 7742 Using Redirect Mode 7943 Tokens 8044 Apple Pay 82

5 Administration Use 8551 Capturing Funds for Authorized Transactions 8652 Canceling Authorized Transactions 8753 Refunding a Captured Order 8854 Creating an order in the Admin 90

6 CyberSource Documentation 92

ii

Recent Changes

Version Release Changes100 March 2017 Initial Release200 August 2017 Added support for Secure Acceptance SOP Electronic Checks

Online Bank Transfers (Bancontact Sofort iDEAL) Tax Calcula-tion and Delivery Address Verification

202 December 2017 Updated settings descriptions and screenshots to reflect recentupdates to the extension

203 January 2018 Added instructions for configuring shipping taxes300 June 2018 Added Account updater module

Added ATP moduleAdded Klarna moduleAdded Visa Checkout moduleAdded ApplePay ModuleSecure Acceptance module reworked with payment methodadapter architectureeCheck module reworked with payment method adapter archi-tecture

310 October 2019 Update for module version 310Update configuration instructions for the new EBCUpdate configuration instructions for Apple Pay module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 1

1 Introduction

The purpose of this manual is to guide a user through the configuration settings and use of theCyberSource Global Payment Management Extension for the Magento 2x ecommerce platform

Where appropriate this manual will reference documentation produced by CyberSource

The CyberSource Global Payment Management Extension for Magento 2 includes the following Cy-berSource payment management capabilities

11 Payment Tokenization with Secure Acceptance

The CyberSource extension for Magento uses Secure Acceptance to securely collect sensitive carddata from the consumerrsquos browser Secure Acceptance prevents sensitive payment data from evertouching your systems to reduce your overall PCI scope potentially allowing merchants to qualify forthe SAQ A or SAQ A-EP

The extension also incorporates CyberSource Tokenization which replaces sensitive payment trans-action data with a unique identifier that cannot be reverse-engineered The unique identifier is calleda payment token (also known as a Profile ID or Subscription ID) which is stored in Magento and takesthe place of sensitive cardholder information allowing your operations to run without sensitive carddata in your environment

12 Credit Card Services

The CyberSource Magento extension includes the following credit card services

bull Authorization

bull Sale (Authorization + Capture)

bull Authorization Reversal

bull Capture

bull Credit

bull Void

2

13 Decision Manager

Decision Manager is a fraud management platform that prevents fraud losses and gives you the flexi-bility to control business practices and policies in real time With DecisionManager you can accuratelyidentify and review potentially risky transactions while minimizing the rejection of valid orders

The CyberSource Magento extension includes

bull Real-time fraud screening performed during Authorization

bull Device Fingerprinting

bull On-Demand Conversion Detail Report for changes in order status

14 Account Takeover Protection

CyberSource Account Takeover Protection defends consumers and merchants from fraudulent usesof online accounts It helps identify high risk users at account creation and login and monitors forsuspicious account changes

The CyberSource Magento extension includes

bull Real-time event screening account creation login and account changes

bull Device Fingerprinting

15 Payer Authentication (3-D Secure)

CyberSource Payer Authentication services enable you to add support to your web store for cardauthentication services offered by Visa MasterCard and other card brands These programs verifythe cardholderrsquos identity directly with the card issuing bank in real-time to increase payment securityand reduce the risk of fraud however Payer Authentication is not a fraud management service andCyberSource recommends that you implement a comprehensive fraud management program such asDecision Manager in addition to Payer Authentication services

The CyberSource Magento extension includes the following Payer Authentication programs

bull Verified by Visa

bull MasterCard Secure Code

bull American Express SafeKey

bull Discover ProtectBuy

bull JCB

bull Dinners

bull Maestro International

Oct 07 2019 CyberSource Global Payment Management for Magento 2 3

16 PayPal Express Checkout

The CyberSource Extension for Magento includes the PayPal Express Checkout payment method Pro-cessing your PayPal transactions through CyberSource allows you to consolidate all payment typesunder a single gateway account simplify integration efforts screen PayPal transactions for fraud withDecision Manager and streamline reporting

The CyberSource Magento extension supports the following PayPal services

bull Sessions

bull Check Status

bull Order

bull Authorization

bull Authorization Reversal

bull Capture

bull Sale

bull Refund

bull PayPal Credit

bull Billing Agreements

17 Electronic Check (eCheck)

Electronic checks also known as e-checks are a form of digital payment that serves the same functionas a physical check When a merchant accepts an electronic check payment the funds are pulleddirectly from the customerrsquos checking or savings account

The CyberSource Magento extension supports the following e-check services

bull Debit

bull Credit

E-checks will process refunds when you use the credit payment service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 4

18 Online Bank Transfers

Online banking services enable customers to pay for goods by pushingmoney from their bank accountto the merchant

The CyberSource Magento extension supports the following payment methods and correspondingonline bank transfer services

bull Bancontact

ndash Sale

ndash Check Status

ndash Refund

ndash Country Belgium

bull Sofort

ndash Sale

ndash Check Status

ndash Refund

ndash Country many European regions

bull iDEAL

ndash Options

ndash Sale

ndash Check Status

ndash Refund

ndash Country Netherlands

bull EPS

ndash Sale

ndash Check Status

ndash Refund

ndash Country Austria

bull giropay

ndash Sale

ndash Check Status

ndash Country Germany

Oct 07 2019 CyberSource Global Payment Management for Magento 2 5

19 Tax Calculation

The tax calculation service provides real-time tax calculation at the time of checkout for orders placedworldwide with your business

The CyberSource Magento extension supports the Tax calculation service

110 Delivery Address Verification

The Delivery Address Verification service verifies typed addresses and corrects invalid citystateZIPcombinations in real-time

The CyberSourceMagento extension supports the Delivery Address Verification service while updatingshipping information if this feature is enabled in the Magento admin

111 PayPal Credit

PayPal Credit is a payment method allowing merchants to accept a PayPal transaction where thecustomer elects to finance their purchase through PayPal

112 Visa Checkout

Visa Checkout can increase sales conversion by making it easier for your customers to pay with theircard online The CyberSource extension for Magento supports the following services

bull Visa Checkout button

bull Get Visa Checkout Data

bull Authorization

bull Sale (Authorization + Capture)

bull Authorization Reversal

bull Capture

bull Credit

bull Void

113 Klarna

Klarna credit provides a seamless user experience for online consumer financing to merchants ofall sizes increasing consumer choice loyalty and grow sales

The goal of this is to implement Authorize Capture and Refund functionality for this pay-ment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 6

2 CyberSource Configuration

Before configuring Magento the CyberSource Enterprise Business Center needs to be configured

Customer payments are managed by both Magento and the CyberSource Enterprise Business Center(EBC) This section covers the mandatory settings that must be configured in the EBC as well as somegeneral use cases that will be typical in the day to day management of your Magento store

Merchants will need to contact CyberSource Customer Support for product availability and enable-ment

21 Secure Acceptance Configuration

To start profile configuration visit the CyberSource Business Center by following one of these URLrsquos

Testing URL httpsebctestcybersourcecomebc2

Production URL httpsebccybersourcecomebc2

In the left navigation panel choose Payment Configuration gt Secure Acceptance Settings

Once on that panel choose the button in the top right labeled Create New Profile

Figure 21 CyberSource Business Center Secure Acceptance Profiles Configuration - New Profile button

7

211 Create New Profile

A Magento instance can have many Secure Acceptance Profiles but you need at least one The Profilewill hold settings related to the cards you accept the currency and other settings including the ProfileID and Security Access Keys needed by Magento to communicate with CyberSource

Figure 22 below shows the profile creation screen Secure Acceptance is offered in two differentmodes

bull Hosted Checkout (formerlyWebMobile) is a hosted payment page available in iframe or redirectmethod

bull Checkout API (formerly Silent Order POST (SOP)) directly posts card data from your customersrsquobrowser to CyberSource The customer never leaves your site and your site never receives anycard data which reduces PCI DSS scope

Ensure you select either the Hosted Checkout or Checkout API Integration Method and select allrelevant checkboxes in the Added Value Services section

Note Payment Tokenization is required for using this extension Decision Manager is optional

Oct 07 2019 CyberSource Global Payment Management for Magento 2 8

Figure 22 CyberSource Business Center Secure Acceptance Profiles Configuration - Create New Profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 9

212 General Settings

Figure 23 CyberSource Business Center Secure Acceptance Profiles Configuration - General Settings

After you have saved the profile you can begin configuring it The first step is General Settings Pleasemake note of the Profile ID This is a key setting needed for Magento See Section 34 and Section 39

Note Payment Tokenization is required

Oct 07 2019 CyberSource Global Payment Management for Magento 2 10

Note Decision Manager and related settings are required only if you use Decision Manager

213 Payment Settings

In this section you can specify which card types are allowed for the payment method You can alsoselect currency CVN Display CVN Required and Payer Authentication options

Note In order to enable PayPal Express Checkout payments just enable and configure it in Magentosettings not here The extension implements PayPal payments natively See Section 310

Oct 07 2019 CyberSource Global Payment Management for Magento 2 11

Figure 24 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Settings

214 Security

In the Security panel you will create an Access Key and a Secret Key needed to complete the setup ofthe Magento 2 Module See Section 34 and Section 39

Oct 07 2019 CyberSource Global Payment Management for Magento 2 12

Figure 25 CyberSource Business Center Secure Acceptance Profiles Configuration - Security Settings

If you still donrsquot have any keys generated click on lsquo+rsquo button and create a new key

Figure 26 CyberSource Business Center Secure Acceptance Profiles Configuration - Key Creation

215 Payment Form

If using Secure Acceptance Hosted Checkout (WebMobile) when a customer is either redirected tothe hosted payment page at CyberSource or if they see the modal popup window during checkoutthey will see a payment form that has been configured with the settings below These settings are notapplicable for the Secure Acceptance Checkout API (Silent Order POST) configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 13

Figure 27 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Form Set-ting

These settings have no effect on the integration with Magento and can be configured to your specificneeds

216 Notifications

On this configuration panel you must choose the Merchant POST URL tick box and input callback URLto your store

Oct 07 2019 CyberSource Global Payment Management for Magento 2 14

Figure 28 CyberSource Business Center Secure Acceptance Profiles Configuration - Notifications Set-tings

The Merchant POST URL is ltyour base urlgt + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Merchant POST URL would behttpwwwexamplecomcybersourceindexplaceOrder

When you configure a Merchant POST URL you will also see additional settings for the card digitsreturned and stored in Magento

217 Customer Response

Response pages are URLrsquos that customers get directed to when a transaction is completed or has beencancelled

Oct 07 2019 CyberSource Global Payment Management for Magento 2 15

Figure 29 CyberSource Business Center Secure Acceptance Profiles Configuration - Customer ResponseConfiguration

Your Transaction Response page URL is your base url + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexplaceOrder

Your Custom Cancel Response Page URL is your base url + cybersourceindexcancel

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexcancel

Oct 07 2019 CyberSource Global Payment Management for Magento 2 16

218 Branding

In this section you can customize look and feel of the Hosted Checkout page It doesnrsquot affect Magentointegration directly These settings are not applicable for the Secure Acceptance Checkout API (SilentOrder POST)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 17

22 Decision Manager

For the purposes of configuring Magento to work with Decision Manager the following sections out-line some brief topics that help describe how Magento and Decision Manger will work together

221 Orders

When enabled Decision Manager runs in real time with the Authorization The possible decisions areACCEPT REJECT REVIEW or ERROR Orders set to REVIEW by Decision Manager will be marked asPending Review in Magento

When you change an order in Decision Manager Case Management from REVIEW to REJECT or AC-CEPT Magento will not immediately learn of this change Magento will learn of any changes to pay-ment transaction states periodically (by cron every 2 minutes) by contacting CyberSource and query-ing for changes Section 36 describes how you configure Magento Cron settings that will trigger aMagento task that will look for Decision Manager changes and update Magento Orders accordingly

If a change in state is detected the module will update the order status in Magento from PendingReview to one of these states Processing Pending Payment or Closed

Please note that if an order is Pending Review in Decision Manager you cannot prepare an invoice inMagento until it is accepted in Decision Manager

222 Refunds

Please note the order must be either Accepted or Rejected in Decision Manager before you are ableto issue a refund Rejecting an order in Decision Manager will automatically perform an AuthorizationReversal for the order as part of the Cron process that queries CyberSource for updates in DecisionManager

223 Custom Fields

Decision Manager supports up to 100 custom fields called Merchant Defined Data Fields The Cy-berSource Module for Magento 2 will send ten of these fields but they must be configured insideDecision Manager in order to make use of them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 18

Figure 210 CyberSource Business Center Decision Manager Custom Fields Configuration

To add the additional custom fields provided by Magento 2 login to the Business Center and navigateto Decision Manager gt Shared Configuration gt Custom Fields Use the tables below to configure thefields

To add a field click the Add Custom Field button select the Order Element and input the name Followthe table below to map the correct element and name

Field Name Order ElementLogged in customer merchant_defined_data1Account creation date merchant_defined_data2Purchase History Count merchant_defined_data3Last Order Date merchant_defined_data4Member account age merchant_defined_data5Repeat customer merchant_defined_data6Coupon Code Used merchant_defined_data20Discount Amount merchant_defined_data21Gift Message merchant_defined_data22Order Source merchant_defined_data23Shipping Method Code merchant_defined_data31Shipping Method Description merchant_defined_data32

For complete Decision Manager configuration instructions please refer to the CyberSource DecisionManager User Guide referenced in Section 6 of this manual

Oct 07 2019 CyberSource Global Payment Management for Magento 2 19

23 Security Credentials

In addition to the Secure Acceptance security credentials created in Section 21 the module usesother connection methods to access CyberSource services that require their own security credentialsfor authentication

Note Configuring of SOAP Toolkit Key is mandatory for this extension proper functioning

231 Create a SOAP Toolkit Key

The CyberSource Module for Magento makes use of the SOAP Toolkit API to access several Cyber-Source services that do not include the transmission of card data

To create a SOAP Toolkit API transaction key navigate in the Enterprise Business Center to PaymentConfiguration gt Key Management

1 Click the ldquoGenerate Keyrdquo button

2 Select the ldquoTransaction processingrdquo key type and click ldquoNext Steprdquo

3 Select the ldquoSOAPrdquo as key subtype and click ldquoSubmitrdquo

4 Save the resulting key for purposes of entering in your Magento configuration

Figure 211 Create a Transaction Security Key - Selecting Key Type

Oct 07 2019 CyberSource Global Payment Management for Magento 2 20

Figure 212 Create a Transaction Security Key - Selecting Key Subtype

Figure 213 Create a Transaction Security Key - Generated SOAP Toolkit Key

Oct 07 2019 CyberSource Global Payment Management for Magento 2 21

232 Create a Report Download User

The CyberSourceModule for Magento uses a reporting API that allowsMagento to query CyberSourcefor information about transactions To activate this you must create a separate CyberSource BusinessCenter user with the role of ldquoReport Downloadrdquo

Figure 214 CyberSource Business Center Main Navigation - User Administration

Navigate to the Account Management gt User Administration section of the main navigation Thescreen will show a listing of active users Click the ldquoAdd Userrdquo button The next screen will look likethis

Oct 07 2019 CyberSource Global Payment Management for Magento 2 22

Figure 215 Add New CyberSource Business Center User Screen

Fill out the form and select lsquoReport Downloadrsquo User Role Once you complete the Add User form anemail will be sent to the address used on the form The email will contain a link and a onetime lsquotokenrsquoused to validate the email account Once the token is entered you will be asked to reset the passwordThis password is needed in Section 31 for the lsquoReport Passwordrsquo

Oct 07 2019 CyberSource Global Payment Management for Magento 2 23

24 Backend Setup

Certain CyberSource services supported by the Module require additional backend setup on yourMerchant ID Please contact your CyberSource Account Representative to enable any of the followingservices

1 Payment Tokenization Required by the Module for Credit Card processing

2 Decision Manager

3 Payer Authentication

4 PayPal Express Checkout New credentials are required for Alt Pay connection Additional setupin PayPal is documented in the PayPal guide listed in Section 6 of this document

5 eChecks

6 Online Bank Transfers

7 Tax Calculation

8 Klarna

9 Account Takeover Protection

10 Account Updater

11 Visa Checkout (enabled in the EBC)

12 Apple Pay (enabled in the EBC)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 24

3 Magento Backend Configuration Settings

Once logged into the administration section of your Magento 2 website the configuration panel isfound by navigating to the following screen

Stores gt Configuration gt Sales gt Payment Methods

Once on that screen you will see the settings for the CyberSource module Inside this panel areadditional sub panels

25

Figure 31 Main CyberSource configuration panel with sub panels

Oct 07 2019 CyberSource Global Payment Management for Magento 2 26

31 General Settings

Figure 32 General Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 27

Figure 33 General Settings (continued)

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of Secure Acceptance

payment method for credit cards This is used for both Web Mobileand Silent Order Post configurations

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 28

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 2: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Table of Contents

1 Introduction 211 Payment Tokenization with Secure Acceptance 212 Credit Card Services 213 Decision Manager 314 Account Takeover Protection 315 Payer Authentication (3-D Secure) 316 PayPal Express Checkout 417 Electronic Check (eCheck) 418 Online Bank Transfers 519 Tax Calculation 6110 Delivery Address Verification 6111 PayPal Credit 6112 Visa Checkout 6113 Klarna 6

2 CyberSource Configuration 721 Secure Acceptance Configuration 722 Decision Manager 1823 Security Credentials 2024 Backend Setup 24

3 Magento Backend Configuration Settings 2531 General Settings 2732 SOAP Web Services Settings 3133 E-Check 3234 Secure Acceptance WebMobile 3635 Token Management Service 3736 3D Secure 20 3837 Delivery Address Verification Service 3938 Klarna 4039 Secure Acceptance Silent Order Post (SOP) 42310 PayPal Express Checkout 43311 Device Fingerprint 45312 Bank Transfer 46313 Visa Checkout 56314 Apple Pay 57315 Account Updater 67

i

316 Taxes 69317 Transactional Emails 75318 Cron Settings 75

4 Payment UX 7641 Using Iframe Mode 7742 Using Redirect Mode 7943 Tokens 8044 Apple Pay 82

5 Administration Use 8551 Capturing Funds for Authorized Transactions 8652 Canceling Authorized Transactions 8753 Refunding a Captured Order 8854 Creating an order in the Admin 90

6 CyberSource Documentation 92

ii

Recent Changes

Version Release Changes100 March 2017 Initial Release200 August 2017 Added support for Secure Acceptance SOP Electronic Checks

Online Bank Transfers (Bancontact Sofort iDEAL) Tax Calcula-tion and Delivery Address Verification

202 December 2017 Updated settings descriptions and screenshots to reflect recentupdates to the extension

203 January 2018 Added instructions for configuring shipping taxes300 June 2018 Added Account updater module

Added ATP moduleAdded Klarna moduleAdded Visa Checkout moduleAdded ApplePay ModuleSecure Acceptance module reworked with payment methodadapter architectureeCheck module reworked with payment method adapter archi-tecture

310 October 2019 Update for module version 310Update configuration instructions for the new EBCUpdate configuration instructions for Apple Pay module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 1

1 Introduction

The purpose of this manual is to guide a user through the configuration settings and use of theCyberSource Global Payment Management Extension for the Magento 2x ecommerce platform

Where appropriate this manual will reference documentation produced by CyberSource

The CyberSource Global Payment Management Extension for Magento 2 includes the following Cy-berSource payment management capabilities

11 Payment Tokenization with Secure Acceptance

The CyberSource extension for Magento uses Secure Acceptance to securely collect sensitive carddata from the consumerrsquos browser Secure Acceptance prevents sensitive payment data from evertouching your systems to reduce your overall PCI scope potentially allowing merchants to qualify forthe SAQ A or SAQ A-EP

The extension also incorporates CyberSource Tokenization which replaces sensitive payment trans-action data with a unique identifier that cannot be reverse-engineered The unique identifier is calleda payment token (also known as a Profile ID or Subscription ID) which is stored in Magento and takesthe place of sensitive cardholder information allowing your operations to run without sensitive carddata in your environment

12 Credit Card Services

The CyberSource Magento extension includes the following credit card services

bull Authorization

bull Sale (Authorization + Capture)

bull Authorization Reversal

bull Capture

bull Credit

bull Void

2

13 Decision Manager

Decision Manager is a fraud management platform that prevents fraud losses and gives you the flexi-bility to control business practices and policies in real time With DecisionManager you can accuratelyidentify and review potentially risky transactions while minimizing the rejection of valid orders

The CyberSource Magento extension includes

bull Real-time fraud screening performed during Authorization

bull Device Fingerprinting

bull On-Demand Conversion Detail Report for changes in order status

14 Account Takeover Protection

CyberSource Account Takeover Protection defends consumers and merchants from fraudulent usesof online accounts It helps identify high risk users at account creation and login and monitors forsuspicious account changes

The CyberSource Magento extension includes

bull Real-time event screening account creation login and account changes

bull Device Fingerprinting

15 Payer Authentication (3-D Secure)

CyberSource Payer Authentication services enable you to add support to your web store for cardauthentication services offered by Visa MasterCard and other card brands These programs verifythe cardholderrsquos identity directly with the card issuing bank in real-time to increase payment securityand reduce the risk of fraud however Payer Authentication is not a fraud management service andCyberSource recommends that you implement a comprehensive fraud management program such asDecision Manager in addition to Payer Authentication services

The CyberSource Magento extension includes the following Payer Authentication programs

bull Verified by Visa

bull MasterCard Secure Code

bull American Express SafeKey

bull Discover ProtectBuy

bull JCB

bull Dinners

bull Maestro International

Oct 07 2019 CyberSource Global Payment Management for Magento 2 3

16 PayPal Express Checkout

The CyberSource Extension for Magento includes the PayPal Express Checkout payment method Pro-cessing your PayPal transactions through CyberSource allows you to consolidate all payment typesunder a single gateway account simplify integration efforts screen PayPal transactions for fraud withDecision Manager and streamline reporting

The CyberSource Magento extension supports the following PayPal services

bull Sessions

bull Check Status

bull Order

bull Authorization

bull Authorization Reversal

bull Capture

bull Sale

bull Refund

bull PayPal Credit

bull Billing Agreements

17 Electronic Check (eCheck)

Electronic checks also known as e-checks are a form of digital payment that serves the same functionas a physical check When a merchant accepts an electronic check payment the funds are pulleddirectly from the customerrsquos checking or savings account

The CyberSource Magento extension supports the following e-check services

bull Debit

bull Credit

E-checks will process refunds when you use the credit payment service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 4

18 Online Bank Transfers

Online banking services enable customers to pay for goods by pushingmoney from their bank accountto the merchant

The CyberSource Magento extension supports the following payment methods and correspondingonline bank transfer services

bull Bancontact

ndash Sale

ndash Check Status

ndash Refund

ndash Country Belgium

bull Sofort

ndash Sale

ndash Check Status

ndash Refund

ndash Country many European regions

bull iDEAL

ndash Options

ndash Sale

ndash Check Status

ndash Refund

ndash Country Netherlands

bull EPS

ndash Sale

ndash Check Status

ndash Refund

ndash Country Austria

bull giropay

ndash Sale

ndash Check Status

ndash Country Germany

Oct 07 2019 CyberSource Global Payment Management for Magento 2 5

19 Tax Calculation

The tax calculation service provides real-time tax calculation at the time of checkout for orders placedworldwide with your business

The CyberSource Magento extension supports the Tax calculation service

110 Delivery Address Verification

The Delivery Address Verification service verifies typed addresses and corrects invalid citystateZIPcombinations in real-time

The CyberSourceMagento extension supports the Delivery Address Verification service while updatingshipping information if this feature is enabled in the Magento admin

111 PayPal Credit

PayPal Credit is a payment method allowing merchants to accept a PayPal transaction where thecustomer elects to finance their purchase through PayPal

112 Visa Checkout

Visa Checkout can increase sales conversion by making it easier for your customers to pay with theircard online The CyberSource extension for Magento supports the following services

bull Visa Checkout button

bull Get Visa Checkout Data

bull Authorization

bull Sale (Authorization + Capture)

bull Authorization Reversal

bull Capture

bull Credit

bull Void

113 Klarna

Klarna credit provides a seamless user experience for online consumer financing to merchants ofall sizes increasing consumer choice loyalty and grow sales

The goal of this is to implement Authorize Capture and Refund functionality for this pay-ment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 6

2 CyberSource Configuration

Before configuring Magento the CyberSource Enterprise Business Center needs to be configured

Customer payments are managed by both Magento and the CyberSource Enterprise Business Center(EBC) This section covers the mandatory settings that must be configured in the EBC as well as somegeneral use cases that will be typical in the day to day management of your Magento store

Merchants will need to contact CyberSource Customer Support for product availability and enable-ment

21 Secure Acceptance Configuration

To start profile configuration visit the CyberSource Business Center by following one of these URLrsquos

Testing URL httpsebctestcybersourcecomebc2

Production URL httpsebccybersourcecomebc2

In the left navigation panel choose Payment Configuration gt Secure Acceptance Settings

Once on that panel choose the button in the top right labeled Create New Profile

Figure 21 CyberSource Business Center Secure Acceptance Profiles Configuration - New Profile button

7

211 Create New Profile

A Magento instance can have many Secure Acceptance Profiles but you need at least one The Profilewill hold settings related to the cards you accept the currency and other settings including the ProfileID and Security Access Keys needed by Magento to communicate with CyberSource

Figure 22 below shows the profile creation screen Secure Acceptance is offered in two differentmodes

bull Hosted Checkout (formerlyWebMobile) is a hosted payment page available in iframe or redirectmethod

bull Checkout API (formerly Silent Order POST (SOP)) directly posts card data from your customersrsquobrowser to CyberSource The customer never leaves your site and your site never receives anycard data which reduces PCI DSS scope

Ensure you select either the Hosted Checkout or Checkout API Integration Method and select allrelevant checkboxes in the Added Value Services section

Note Payment Tokenization is required for using this extension Decision Manager is optional

Oct 07 2019 CyberSource Global Payment Management for Magento 2 8

Figure 22 CyberSource Business Center Secure Acceptance Profiles Configuration - Create New Profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 9

212 General Settings

Figure 23 CyberSource Business Center Secure Acceptance Profiles Configuration - General Settings

After you have saved the profile you can begin configuring it The first step is General Settings Pleasemake note of the Profile ID This is a key setting needed for Magento See Section 34 and Section 39

Note Payment Tokenization is required

Oct 07 2019 CyberSource Global Payment Management for Magento 2 10

Note Decision Manager and related settings are required only if you use Decision Manager

213 Payment Settings

In this section you can specify which card types are allowed for the payment method You can alsoselect currency CVN Display CVN Required and Payer Authentication options

Note In order to enable PayPal Express Checkout payments just enable and configure it in Magentosettings not here The extension implements PayPal payments natively See Section 310

Oct 07 2019 CyberSource Global Payment Management for Magento 2 11

Figure 24 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Settings

214 Security

In the Security panel you will create an Access Key and a Secret Key needed to complete the setup ofthe Magento 2 Module See Section 34 and Section 39

Oct 07 2019 CyberSource Global Payment Management for Magento 2 12

Figure 25 CyberSource Business Center Secure Acceptance Profiles Configuration - Security Settings

If you still donrsquot have any keys generated click on lsquo+rsquo button and create a new key

Figure 26 CyberSource Business Center Secure Acceptance Profiles Configuration - Key Creation

215 Payment Form

If using Secure Acceptance Hosted Checkout (WebMobile) when a customer is either redirected tothe hosted payment page at CyberSource or if they see the modal popup window during checkoutthey will see a payment form that has been configured with the settings below These settings are notapplicable for the Secure Acceptance Checkout API (Silent Order POST) configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 13

Figure 27 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Form Set-ting

These settings have no effect on the integration with Magento and can be configured to your specificneeds

216 Notifications

On this configuration panel you must choose the Merchant POST URL tick box and input callback URLto your store

Oct 07 2019 CyberSource Global Payment Management for Magento 2 14

Figure 28 CyberSource Business Center Secure Acceptance Profiles Configuration - Notifications Set-tings

The Merchant POST URL is ltyour base urlgt + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Merchant POST URL would behttpwwwexamplecomcybersourceindexplaceOrder

When you configure a Merchant POST URL you will also see additional settings for the card digitsreturned and stored in Magento

217 Customer Response

Response pages are URLrsquos that customers get directed to when a transaction is completed or has beencancelled

Oct 07 2019 CyberSource Global Payment Management for Magento 2 15

Figure 29 CyberSource Business Center Secure Acceptance Profiles Configuration - Customer ResponseConfiguration

Your Transaction Response page URL is your base url + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexplaceOrder

Your Custom Cancel Response Page URL is your base url + cybersourceindexcancel

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexcancel

Oct 07 2019 CyberSource Global Payment Management for Magento 2 16

218 Branding

In this section you can customize look and feel of the Hosted Checkout page It doesnrsquot affect Magentointegration directly These settings are not applicable for the Secure Acceptance Checkout API (SilentOrder POST)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 17

22 Decision Manager

For the purposes of configuring Magento to work with Decision Manager the following sections out-line some brief topics that help describe how Magento and Decision Manger will work together

221 Orders

When enabled Decision Manager runs in real time with the Authorization The possible decisions areACCEPT REJECT REVIEW or ERROR Orders set to REVIEW by Decision Manager will be marked asPending Review in Magento

When you change an order in Decision Manager Case Management from REVIEW to REJECT or AC-CEPT Magento will not immediately learn of this change Magento will learn of any changes to pay-ment transaction states periodically (by cron every 2 minutes) by contacting CyberSource and query-ing for changes Section 36 describes how you configure Magento Cron settings that will trigger aMagento task that will look for Decision Manager changes and update Magento Orders accordingly

If a change in state is detected the module will update the order status in Magento from PendingReview to one of these states Processing Pending Payment or Closed

Please note that if an order is Pending Review in Decision Manager you cannot prepare an invoice inMagento until it is accepted in Decision Manager

222 Refunds

Please note the order must be either Accepted or Rejected in Decision Manager before you are ableto issue a refund Rejecting an order in Decision Manager will automatically perform an AuthorizationReversal for the order as part of the Cron process that queries CyberSource for updates in DecisionManager

223 Custom Fields

Decision Manager supports up to 100 custom fields called Merchant Defined Data Fields The Cy-berSource Module for Magento 2 will send ten of these fields but they must be configured insideDecision Manager in order to make use of them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 18

Figure 210 CyberSource Business Center Decision Manager Custom Fields Configuration

To add the additional custom fields provided by Magento 2 login to the Business Center and navigateto Decision Manager gt Shared Configuration gt Custom Fields Use the tables below to configure thefields

To add a field click the Add Custom Field button select the Order Element and input the name Followthe table below to map the correct element and name

Field Name Order ElementLogged in customer merchant_defined_data1Account creation date merchant_defined_data2Purchase History Count merchant_defined_data3Last Order Date merchant_defined_data4Member account age merchant_defined_data5Repeat customer merchant_defined_data6Coupon Code Used merchant_defined_data20Discount Amount merchant_defined_data21Gift Message merchant_defined_data22Order Source merchant_defined_data23Shipping Method Code merchant_defined_data31Shipping Method Description merchant_defined_data32

For complete Decision Manager configuration instructions please refer to the CyberSource DecisionManager User Guide referenced in Section 6 of this manual

Oct 07 2019 CyberSource Global Payment Management for Magento 2 19

23 Security Credentials

In addition to the Secure Acceptance security credentials created in Section 21 the module usesother connection methods to access CyberSource services that require their own security credentialsfor authentication

Note Configuring of SOAP Toolkit Key is mandatory for this extension proper functioning

231 Create a SOAP Toolkit Key

The CyberSource Module for Magento makes use of the SOAP Toolkit API to access several Cyber-Source services that do not include the transmission of card data

To create a SOAP Toolkit API transaction key navigate in the Enterprise Business Center to PaymentConfiguration gt Key Management

1 Click the ldquoGenerate Keyrdquo button

2 Select the ldquoTransaction processingrdquo key type and click ldquoNext Steprdquo

3 Select the ldquoSOAPrdquo as key subtype and click ldquoSubmitrdquo

4 Save the resulting key for purposes of entering in your Magento configuration

Figure 211 Create a Transaction Security Key - Selecting Key Type

Oct 07 2019 CyberSource Global Payment Management for Magento 2 20

Figure 212 Create a Transaction Security Key - Selecting Key Subtype

Figure 213 Create a Transaction Security Key - Generated SOAP Toolkit Key

Oct 07 2019 CyberSource Global Payment Management for Magento 2 21

232 Create a Report Download User

The CyberSourceModule for Magento uses a reporting API that allowsMagento to query CyberSourcefor information about transactions To activate this you must create a separate CyberSource BusinessCenter user with the role of ldquoReport Downloadrdquo

Figure 214 CyberSource Business Center Main Navigation - User Administration

Navigate to the Account Management gt User Administration section of the main navigation Thescreen will show a listing of active users Click the ldquoAdd Userrdquo button The next screen will look likethis

Oct 07 2019 CyberSource Global Payment Management for Magento 2 22

Figure 215 Add New CyberSource Business Center User Screen

Fill out the form and select lsquoReport Downloadrsquo User Role Once you complete the Add User form anemail will be sent to the address used on the form The email will contain a link and a onetime lsquotokenrsquoused to validate the email account Once the token is entered you will be asked to reset the passwordThis password is needed in Section 31 for the lsquoReport Passwordrsquo

Oct 07 2019 CyberSource Global Payment Management for Magento 2 23

24 Backend Setup

Certain CyberSource services supported by the Module require additional backend setup on yourMerchant ID Please contact your CyberSource Account Representative to enable any of the followingservices

1 Payment Tokenization Required by the Module for Credit Card processing

2 Decision Manager

3 Payer Authentication

4 PayPal Express Checkout New credentials are required for Alt Pay connection Additional setupin PayPal is documented in the PayPal guide listed in Section 6 of this document

5 eChecks

6 Online Bank Transfers

7 Tax Calculation

8 Klarna

9 Account Takeover Protection

10 Account Updater

11 Visa Checkout (enabled in the EBC)

12 Apple Pay (enabled in the EBC)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 24

3 Magento Backend Configuration Settings

Once logged into the administration section of your Magento 2 website the configuration panel isfound by navigating to the following screen

Stores gt Configuration gt Sales gt Payment Methods

Once on that screen you will see the settings for the CyberSource module Inside this panel areadditional sub panels

25

Figure 31 Main CyberSource configuration panel with sub panels

Oct 07 2019 CyberSource Global Payment Management for Magento 2 26

31 General Settings

Figure 32 General Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 27

Figure 33 General Settings (continued)

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of Secure Acceptance

payment method for credit cards This is used for both Web Mobileand Silent Order Post configurations

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 28

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 3: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

316 Taxes 69317 Transactional Emails 75318 Cron Settings 75

4 Payment UX 7641 Using Iframe Mode 7742 Using Redirect Mode 7943 Tokens 8044 Apple Pay 82

5 Administration Use 8551 Capturing Funds for Authorized Transactions 8652 Canceling Authorized Transactions 8753 Refunding a Captured Order 8854 Creating an order in the Admin 90

6 CyberSource Documentation 92

ii

Recent Changes

Version Release Changes100 March 2017 Initial Release200 August 2017 Added support for Secure Acceptance SOP Electronic Checks

Online Bank Transfers (Bancontact Sofort iDEAL) Tax Calcula-tion and Delivery Address Verification

202 December 2017 Updated settings descriptions and screenshots to reflect recentupdates to the extension

203 January 2018 Added instructions for configuring shipping taxes300 June 2018 Added Account updater module

Added ATP moduleAdded Klarna moduleAdded Visa Checkout moduleAdded ApplePay ModuleSecure Acceptance module reworked with payment methodadapter architectureeCheck module reworked with payment method adapter archi-tecture

310 October 2019 Update for module version 310Update configuration instructions for the new EBCUpdate configuration instructions for Apple Pay module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 1

1 Introduction

The purpose of this manual is to guide a user through the configuration settings and use of theCyberSource Global Payment Management Extension for the Magento 2x ecommerce platform

Where appropriate this manual will reference documentation produced by CyberSource

The CyberSource Global Payment Management Extension for Magento 2 includes the following Cy-berSource payment management capabilities

11 Payment Tokenization with Secure Acceptance

The CyberSource extension for Magento uses Secure Acceptance to securely collect sensitive carddata from the consumerrsquos browser Secure Acceptance prevents sensitive payment data from evertouching your systems to reduce your overall PCI scope potentially allowing merchants to qualify forthe SAQ A or SAQ A-EP

The extension also incorporates CyberSource Tokenization which replaces sensitive payment trans-action data with a unique identifier that cannot be reverse-engineered The unique identifier is calleda payment token (also known as a Profile ID or Subscription ID) which is stored in Magento and takesthe place of sensitive cardholder information allowing your operations to run without sensitive carddata in your environment

12 Credit Card Services

The CyberSource Magento extension includes the following credit card services

bull Authorization

bull Sale (Authorization + Capture)

bull Authorization Reversal

bull Capture

bull Credit

bull Void

2

13 Decision Manager

Decision Manager is a fraud management platform that prevents fraud losses and gives you the flexi-bility to control business practices and policies in real time With DecisionManager you can accuratelyidentify and review potentially risky transactions while minimizing the rejection of valid orders

The CyberSource Magento extension includes

bull Real-time fraud screening performed during Authorization

bull Device Fingerprinting

bull On-Demand Conversion Detail Report for changes in order status

14 Account Takeover Protection

CyberSource Account Takeover Protection defends consumers and merchants from fraudulent usesof online accounts It helps identify high risk users at account creation and login and monitors forsuspicious account changes

The CyberSource Magento extension includes

bull Real-time event screening account creation login and account changes

bull Device Fingerprinting

15 Payer Authentication (3-D Secure)

CyberSource Payer Authentication services enable you to add support to your web store for cardauthentication services offered by Visa MasterCard and other card brands These programs verifythe cardholderrsquos identity directly with the card issuing bank in real-time to increase payment securityand reduce the risk of fraud however Payer Authentication is not a fraud management service andCyberSource recommends that you implement a comprehensive fraud management program such asDecision Manager in addition to Payer Authentication services

The CyberSource Magento extension includes the following Payer Authentication programs

bull Verified by Visa

bull MasterCard Secure Code

bull American Express SafeKey

bull Discover ProtectBuy

bull JCB

bull Dinners

bull Maestro International

Oct 07 2019 CyberSource Global Payment Management for Magento 2 3

16 PayPal Express Checkout

The CyberSource Extension for Magento includes the PayPal Express Checkout payment method Pro-cessing your PayPal transactions through CyberSource allows you to consolidate all payment typesunder a single gateway account simplify integration efforts screen PayPal transactions for fraud withDecision Manager and streamline reporting

The CyberSource Magento extension supports the following PayPal services

bull Sessions

bull Check Status

bull Order

bull Authorization

bull Authorization Reversal

bull Capture

bull Sale

bull Refund

bull PayPal Credit

bull Billing Agreements

17 Electronic Check (eCheck)

Electronic checks also known as e-checks are a form of digital payment that serves the same functionas a physical check When a merchant accepts an electronic check payment the funds are pulleddirectly from the customerrsquos checking or savings account

The CyberSource Magento extension supports the following e-check services

bull Debit

bull Credit

E-checks will process refunds when you use the credit payment service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 4

18 Online Bank Transfers

Online banking services enable customers to pay for goods by pushingmoney from their bank accountto the merchant

The CyberSource Magento extension supports the following payment methods and correspondingonline bank transfer services

bull Bancontact

ndash Sale

ndash Check Status

ndash Refund

ndash Country Belgium

bull Sofort

ndash Sale

ndash Check Status

ndash Refund

ndash Country many European regions

bull iDEAL

ndash Options

ndash Sale

ndash Check Status

ndash Refund

ndash Country Netherlands

bull EPS

ndash Sale

ndash Check Status

ndash Refund

ndash Country Austria

bull giropay

ndash Sale

ndash Check Status

ndash Country Germany

Oct 07 2019 CyberSource Global Payment Management for Magento 2 5

19 Tax Calculation

The tax calculation service provides real-time tax calculation at the time of checkout for orders placedworldwide with your business

The CyberSource Magento extension supports the Tax calculation service

110 Delivery Address Verification

The Delivery Address Verification service verifies typed addresses and corrects invalid citystateZIPcombinations in real-time

The CyberSourceMagento extension supports the Delivery Address Verification service while updatingshipping information if this feature is enabled in the Magento admin

111 PayPal Credit

PayPal Credit is a payment method allowing merchants to accept a PayPal transaction where thecustomer elects to finance their purchase through PayPal

112 Visa Checkout

Visa Checkout can increase sales conversion by making it easier for your customers to pay with theircard online The CyberSource extension for Magento supports the following services

bull Visa Checkout button

bull Get Visa Checkout Data

bull Authorization

bull Sale (Authorization + Capture)

bull Authorization Reversal

bull Capture

bull Credit

bull Void

113 Klarna

Klarna credit provides a seamless user experience for online consumer financing to merchants ofall sizes increasing consumer choice loyalty and grow sales

The goal of this is to implement Authorize Capture and Refund functionality for this pay-ment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 6

2 CyberSource Configuration

Before configuring Magento the CyberSource Enterprise Business Center needs to be configured

Customer payments are managed by both Magento and the CyberSource Enterprise Business Center(EBC) This section covers the mandatory settings that must be configured in the EBC as well as somegeneral use cases that will be typical in the day to day management of your Magento store

Merchants will need to contact CyberSource Customer Support for product availability and enable-ment

21 Secure Acceptance Configuration

To start profile configuration visit the CyberSource Business Center by following one of these URLrsquos

Testing URL httpsebctestcybersourcecomebc2

Production URL httpsebccybersourcecomebc2

In the left navigation panel choose Payment Configuration gt Secure Acceptance Settings

Once on that panel choose the button in the top right labeled Create New Profile

Figure 21 CyberSource Business Center Secure Acceptance Profiles Configuration - New Profile button

7

211 Create New Profile

A Magento instance can have many Secure Acceptance Profiles but you need at least one The Profilewill hold settings related to the cards you accept the currency and other settings including the ProfileID and Security Access Keys needed by Magento to communicate with CyberSource

Figure 22 below shows the profile creation screen Secure Acceptance is offered in two differentmodes

bull Hosted Checkout (formerlyWebMobile) is a hosted payment page available in iframe or redirectmethod

bull Checkout API (formerly Silent Order POST (SOP)) directly posts card data from your customersrsquobrowser to CyberSource The customer never leaves your site and your site never receives anycard data which reduces PCI DSS scope

Ensure you select either the Hosted Checkout or Checkout API Integration Method and select allrelevant checkboxes in the Added Value Services section

Note Payment Tokenization is required for using this extension Decision Manager is optional

Oct 07 2019 CyberSource Global Payment Management for Magento 2 8

Figure 22 CyberSource Business Center Secure Acceptance Profiles Configuration - Create New Profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 9

212 General Settings

Figure 23 CyberSource Business Center Secure Acceptance Profiles Configuration - General Settings

After you have saved the profile you can begin configuring it The first step is General Settings Pleasemake note of the Profile ID This is a key setting needed for Magento See Section 34 and Section 39

Note Payment Tokenization is required

Oct 07 2019 CyberSource Global Payment Management for Magento 2 10

Note Decision Manager and related settings are required only if you use Decision Manager

213 Payment Settings

In this section you can specify which card types are allowed for the payment method You can alsoselect currency CVN Display CVN Required and Payer Authentication options

Note In order to enable PayPal Express Checkout payments just enable and configure it in Magentosettings not here The extension implements PayPal payments natively See Section 310

Oct 07 2019 CyberSource Global Payment Management for Magento 2 11

Figure 24 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Settings

214 Security

In the Security panel you will create an Access Key and a Secret Key needed to complete the setup ofthe Magento 2 Module See Section 34 and Section 39

Oct 07 2019 CyberSource Global Payment Management for Magento 2 12

Figure 25 CyberSource Business Center Secure Acceptance Profiles Configuration - Security Settings

If you still donrsquot have any keys generated click on lsquo+rsquo button and create a new key

Figure 26 CyberSource Business Center Secure Acceptance Profiles Configuration - Key Creation

215 Payment Form

If using Secure Acceptance Hosted Checkout (WebMobile) when a customer is either redirected tothe hosted payment page at CyberSource or if they see the modal popup window during checkoutthey will see a payment form that has been configured with the settings below These settings are notapplicable for the Secure Acceptance Checkout API (Silent Order POST) configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 13

Figure 27 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Form Set-ting

These settings have no effect on the integration with Magento and can be configured to your specificneeds

216 Notifications

On this configuration panel you must choose the Merchant POST URL tick box and input callback URLto your store

Oct 07 2019 CyberSource Global Payment Management for Magento 2 14

Figure 28 CyberSource Business Center Secure Acceptance Profiles Configuration - Notifications Set-tings

The Merchant POST URL is ltyour base urlgt + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Merchant POST URL would behttpwwwexamplecomcybersourceindexplaceOrder

When you configure a Merchant POST URL you will also see additional settings for the card digitsreturned and stored in Magento

217 Customer Response

Response pages are URLrsquos that customers get directed to when a transaction is completed or has beencancelled

Oct 07 2019 CyberSource Global Payment Management for Magento 2 15

Figure 29 CyberSource Business Center Secure Acceptance Profiles Configuration - Customer ResponseConfiguration

Your Transaction Response page URL is your base url + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexplaceOrder

Your Custom Cancel Response Page URL is your base url + cybersourceindexcancel

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexcancel

Oct 07 2019 CyberSource Global Payment Management for Magento 2 16

218 Branding

In this section you can customize look and feel of the Hosted Checkout page It doesnrsquot affect Magentointegration directly These settings are not applicable for the Secure Acceptance Checkout API (SilentOrder POST)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 17

22 Decision Manager

For the purposes of configuring Magento to work with Decision Manager the following sections out-line some brief topics that help describe how Magento and Decision Manger will work together

221 Orders

When enabled Decision Manager runs in real time with the Authorization The possible decisions areACCEPT REJECT REVIEW or ERROR Orders set to REVIEW by Decision Manager will be marked asPending Review in Magento

When you change an order in Decision Manager Case Management from REVIEW to REJECT or AC-CEPT Magento will not immediately learn of this change Magento will learn of any changes to pay-ment transaction states periodically (by cron every 2 minutes) by contacting CyberSource and query-ing for changes Section 36 describes how you configure Magento Cron settings that will trigger aMagento task that will look for Decision Manager changes and update Magento Orders accordingly

If a change in state is detected the module will update the order status in Magento from PendingReview to one of these states Processing Pending Payment or Closed

Please note that if an order is Pending Review in Decision Manager you cannot prepare an invoice inMagento until it is accepted in Decision Manager

222 Refunds

Please note the order must be either Accepted or Rejected in Decision Manager before you are ableto issue a refund Rejecting an order in Decision Manager will automatically perform an AuthorizationReversal for the order as part of the Cron process that queries CyberSource for updates in DecisionManager

223 Custom Fields

Decision Manager supports up to 100 custom fields called Merchant Defined Data Fields The Cy-berSource Module for Magento 2 will send ten of these fields but they must be configured insideDecision Manager in order to make use of them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 18

Figure 210 CyberSource Business Center Decision Manager Custom Fields Configuration

To add the additional custom fields provided by Magento 2 login to the Business Center and navigateto Decision Manager gt Shared Configuration gt Custom Fields Use the tables below to configure thefields

To add a field click the Add Custom Field button select the Order Element and input the name Followthe table below to map the correct element and name

Field Name Order ElementLogged in customer merchant_defined_data1Account creation date merchant_defined_data2Purchase History Count merchant_defined_data3Last Order Date merchant_defined_data4Member account age merchant_defined_data5Repeat customer merchant_defined_data6Coupon Code Used merchant_defined_data20Discount Amount merchant_defined_data21Gift Message merchant_defined_data22Order Source merchant_defined_data23Shipping Method Code merchant_defined_data31Shipping Method Description merchant_defined_data32

For complete Decision Manager configuration instructions please refer to the CyberSource DecisionManager User Guide referenced in Section 6 of this manual

Oct 07 2019 CyberSource Global Payment Management for Magento 2 19

23 Security Credentials

In addition to the Secure Acceptance security credentials created in Section 21 the module usesother connection methods to access CyberSource services that require their own security credentialsfor authentication

Note Configuring of SOAP Toolkit Key is mandatory for this extension proper functioning

231 Create a SOAP Toolkit Key

The CyberSource Module for Magento makes use of the SOAP Toolkit API to access several Cyber-Source services that do not include the transmission of card data

To create a SOAP Toolkit API transaction key navigate in the Enterprise Business Center to PaymentConfiguration gt Key Management

1 Click the ldquoGenerate Keyrdquo button

2 Select the ldquoTransaction processingrdquo key type and click ldquoNext Steprdquo

3 Select the ldquoSOAPrdquo as key subtype and click ldquoSubmitrdquo

4 Save the resulting key for purposes of entering in your Magento configuration

Figure 211 Create a Transaction Security Key - Selecting Key Type

Oct 07 2019 CyberSource Global Payment Management for Magento 2 20

Figure 212 Create a Transaction Security Key - Selecting Key Subtype

Figure 213 Create a Transaction Security Key - Generated SOAP Toolkit Key

Oct 07 2019 CyberSource Global Payment Management for Magento 2 21

232 Create a Report Download User

The CyberSourceModule for Magento uses a reporting API that allowsMagento to query CyberSourcefor information about transactions To activate this you must create a separate CyberSource BusinessCenter user with the role of ldquoReport Downloadrdquo

Figure 214 CyberSource Business Center Main Navigation - User Administration

Navigate to the Account Management gt User Administration section of the main navigation Thescreen will show a listing of active users Click the ldquoAdd Userrdquo button The next screen will look likethis

Oct 07 2019 CyberSource Global Payment Management for Magento 2 22

Figure 215 Add New CyberSource Business Center User Screen

Fill out the form and select lsquoReport Downloadrsquo User Role Once you complete the Add User form anemail will be sent to the address used on the form The email will contain a link and a onetime lsquotokenrsquoused to validate the email account Once the token is entered you will be asked to reset the passwordThis password is needed in Section 31 for the lsquoReport Passwordrsquo

Oct 07 2019 CyberSource Global Payment Management for Magento 2 23

24 Backend Setup

Certain CyberSource services supported by the Module require additional backend setup on yourMerchant ID Please contact your CyberSource Account Representative to enable any of the followingservices

1 Payment Tokenization Required by the Module for Credit Card processing

2 Decision Manager

3 Payer Authentication

4 PayPal Express Checkout New credentials are required for Alt Pay connection Additional setupin PayPal is documented in the PayPal guide listed in Section 6 of this document

5 eChecks

6 Online Bank Transfers

7 Tax Calculation

8 Klarna

9 Account Takeover Protection

10 Account Updater

11 Visa Checkout (enabled in the EBC)

12 Apple Pay (enabled in the EBC)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 24

3 Magento Backend Configuration Settings

Once logged into the administration section of your Magento 2 website the configuration panel isfound by navigating to the following screen

Stores gt Configuration gt Sales gt Payment Methods

Once on that screen you will see the settings for the CyberSource module Inside this panel areadditional sub panels

25

Figure 31 Main CyberSource configuration panel with sub panels

Oct 07 2019 CyberSource Global Payment Management for Magento 2 26

31 General Settings

Figure 32 General Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 27

Figure 33 General Settings (continued)

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of Secure Acceptance

payment method for credit cards This is used for both Web Mobileand Silent Order Post configurations

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 28

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 4: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Recent Changes

Version Release Changes100 March 2017 Initial Release200 August 2017 Added support for Secure Acceptance SOP Electronic Checks

Online Bank Transfers (Bancontact Sofort iDEAL) Tax Calcula-tion and Delivery Address Verification

202 December 2017 Updated settings descriptions and screenshots to reflect recentupdates to the extension

203 January 2018 Added instructions for configuring shipping taxes300 June 2018 Added Account updater module

Added ATP moduleAdded Klarna moduleAdded Visa Checkout moduleAdded ApplePay ModuleSecure Acceptance module reworked with payment methodadapter architectureeCheck module reworked with payment method adapter archi-tecture

310 October 2019 Update for module version 310Update configuration instructions for the new EBCUpdate configuration instructions for Apple Pay module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 1

1 Introduction

The purpose of this manual is to guide a user through the configuration settings and use of theCyberSource Global Payment Management Extension for the Magento 2x ecommerce platform

Where appropriate this manual will reference documentation produced by CyberSource

The CyberSource Global Payment Management Extension for Magento 2 includes the following Cy-berSource payment management capabilities

11 Payment Tokenization with Secure Acceptance

The CyberSource extension for Magento uses Secure Acceptance to securely collect sensitive carddata from the consumerrsquos browser Secure Acceptance prevents sensitive payment data from evertouching your systems to reduce your overall PCI scope potentially allowing merchants to qualify forthe SAQ A or SAQ A-EP

The extension also incorporates CyberSource Tokenization which replaces sensitive payment trans-action data with a unique identifier that cannot be reverse-engineered The unique identifier is calleda payment token (also known as a Profile ID or Subscription ID) which is stored in Magento and takesthe place of sensitive cardholder information allowing your operations to run without sensitive carddata in your environment

12 Credit Card Services

The CyberSource Magento extension includes the following credit card services

bull Authorization

bull Sale (Authorization + Capture)

bull Authorization Reversal

bull Capture

bull Credit

bull Void

2

13 Decision Manager

Decision Manager is a fraud management platform that prevents fraud losses and gives you the flexi-bility to control business practices and policies in real time With DecisionManager you can accuratelyidentify and review potentially risky transactions while minimizing the rejection of valid orders

The CyberSource Magento extension includes

bull Real-time fraud screening performed during Authorization

bull Device Fingerprinting

bull On-Demand Conversion Detail Report for changes in order status

14 Account Takeover Protection

CyberSource Account Takeover Protection defends consumers and merchants from fraudulent usesof online accounts It helps identify high risk users at account creation and login and monitors forsuspicious account changes

The CyberSource Magento extension includes

bull Real-time event screening account creation login and account changes

bull Device Fingerprinting

15 Payer Authentication (3-D Secure)

CyberSource Payer Authentication services enable you to add support to your web store for cardauthentication services offered by Visa MasterCard and other card brands These programs verifythe cardholderrsquos identity directly with the card issuing bank in real-time to increase payment securityand reduce the risk of fraud however Payer Authentication is not a fraud management service andCyberSource recommends that you implement a comprehensive fraud management program such asDecision Manager in addition to Payer Authentication services

The CyberSource Magento extension includes the following Payer Authentication programs

bull Verified by Visa

bull MasterCard Secure Code

bull American Express SafeKey

bull Discover ProtectBuy

bull JCB

bull Dinners

bull Maestro International

Oct 07 2019 CyberSource Global Payment Management for Magento 2 3

16 PayPal Express Checkout

The CyberSource Extension for Magento includes the PayPal Express Checkout payment method Pro-cessing your PayPal transactions through CyberSource allows you to consolidate all payment typesunder a single gateway account simplify integration efforts screen PayPal transactions for fraud withDecision Manager and streamline reporting

The CyberSource Magento extension supports the following PayPal services

bull Sessions

bull Check Status

bull Order

bull Authorization

bull Authorization Reversal

bull Capture

bull Sale

bull Refund

bull PayPal Credit

bull Billing Agreements

17 Electronic Check (eCheck)

Electronic checks also known as e-checks are a form of digital payment that serves the same functionas a physical check When a merchant accepts an electronic check payment the funds are pulleddirectly from the customerrsquos checking or savings account

The CyberSource Magento extension supports the following e-check services

bull Debit

bull Credit

E-checks will process refunds when you use the credit payment service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 4

18 Online Bank Transfers

Online banking services enable customers to pay for goods by pushingmoney from their bank accountto the merchant

The CyberSource Magento extension supports the following payment methods and correspondingonline bank transfer services

bull Bancontact

ndash Sale

ndash Check Status

ndash Refund

ndash Country Belgium

bull Sofort

ndash Sale

ndash Check Status

ndash Refund

ndash Country many European regions

bull iDEAL

ndash Options

ndash Sale

ndash Check Status

ndash Refund

ndash Country Netherlands

bull EPS

ndash Sale

ndash Check Status

ndash Refund

ndash Country Austria

bull giropay

ndash Sale

ndash Check Status

ndash Country Germany

Oct 07 2019 CyberSource Global Payment Management for Magento 2 5

19 Tax Calculation

The tax calculation service provides real-time tax calculation at the time of checkout for orders placedworldwide with your business

The CyberSource Magento extension supports the Tax calculation service

110 Delivery Address Verification

The Delivery Address Verification service verifies typed addresses and corrects invalid citystateZIPcombinations in real-time

The CyberSourceMagento extension supports the Delivery Address Verification service while updatingshipping information if this feature is enabled in the Magento admin

111 PayPal Credit

PayPal Credit is a payment method allowing merchants to accept a PayPal transaction where thecustomer elects to finance their purchase through PayPal

112 Visa Checkout

Visa Checkout can increase sales conversion by making it easier for your customers to pay with theircard online The CyberSource extension for Magento supports the following services

bull Visa Checkout button

bull Get Visa Checkout Data

bull Authorization

bull Sale (Authorization + Capture)

bull Authorization Reversal

bull Capture

bull Credit

bull Void

113 Klarna

Klarna credit provides a seamless user experience for online consumer financing to merchants ofall sizes increasing consumer choice loyalty and grow sales

The goal of this is to implement Authorize Capture and Refund functionality for this pay-ment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 6

2 CyberSource Configuration

Before configuring Magento the CyberSource Enterprise Business Center needs to be configured

Customer payments are managed by both Magento and the CyberSource Enterprise Business Center(EBC) This section covers the mandatory settings that must be configured in the EBC as well as somegeneral use cases that will be typical in the day to day management of your Magento store

Merchants will need to contact CyberSource Customer Support for product availability and enable-ment

21 Secure Acceptance Configuration

To start profile configuration visit the CyberSource Business Center by following one of these URLrsquos

Testing URL httpsebctestcybersourcecomebc2

Production URL httpsebccybersourcecomebc2

In the left navigation panel choose Payment Configuration gt Secure Acceptance Settings

Once on that panel choose the button in the top right labeled Create New Profile

Figure 21 CyberSource Business Center Secure Acceptance Profiles Configuration - New Profile button

7

211 Create New Profile

A Magento instance can have many Secure Acceptance Profiles but you need at least one The Profilewill hold settings related to the cards you accept the currency and other settings including the ProfileID and Security Access Keys needed by Magento to communicate with CyberSource

Figure 22 below shows the profile creation screen Secure Acceptance is offered in two differentmodes

bull Hosted Checkout (formerlyWebMobile) is a hosted payment page available in iframe or redirectmethod

bull Checkout API (formerly Silent Order POST (SOP)) directly posts card data from your customersrsquobrowser to CyberSource The customer never leaves your site and your site never receives anycard data which reduces PCI DSS scope

Ensure you select either the Hosted Checkout or Checkout API Integration Method and select allrelevant checkboxes in the Added Value Services section

Note Payment Tokenization is required for using this extension Decision Manager is optional

Oct 07 2019 CyberSource Global Payment Management for Magento 2 8

Figure 22 CyberSource Business Center Secure Acceptance Profiles Configuration - Create New Profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 9

212 General Settings

Figure 23 CyberSource Business Center Secure Acceptance Profiles Configuration - General Settings

After you have saved the profile you can begin configuring it The first step is General Settings Pleasemake note of the Profile ID This is a key setting needed for Magento See Section 34 and Section 39

Note Payment Tokenization is required

Oct 07 2019 CyberSource Global Payment Management for Magento 2 10

Note Decision Manager and related settings are required only if you use Decision Manager

213 Payment Settings

In this section you can specify which card types are allowed for the payment method You can alsoselect currency CVN Display CVN Required and Payer Authentication options

Note In order to enable PayPal Express Checkout payments just enable and configure it in Magentosettings not here The extension implements PayPal payments natively See Section 310

Oct 07 2019 CyberSource Global Payment Management for Magento 2 11

Figure 24 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Settings

214 Security

In the Security panel you will create an Access Key and a Secret Key needed to complete the setup ofthe Magento 2 Module See Section 34 and Section 39

Oct 07 2019 CyberSource Global Payment Management for Magento 2 12

Figure 25 CyberSource Business Center Secure Acceptance Profiles Configuration - Security Settings

If you still donrsquot have any keys generated click on lsquo+rsquo button and create a new key

Figure 26 CyberSource Business Center Secure Acceptance Profiles Configuration - Key Creation

215 Payment Form

If using Secure Acceptance Hosted Checkout (WebMobile) when a customer is either redirected tothe hosted payment page at CyberSource or if they see the modal popup window during checkoutthey will see a payment form that has been configured with the settings below These settings are notapplicable for the Secure Acceptance Checkout API (Silent Order POST) configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 13

Figure 27 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Form Set-ting

These settings have no effect on the integration with Magento and can be configured to your specificneeds

216 Notifications

On this configuration panel you must choose the Merchant POST URL tick box and input callback URLto your store

Oct 07 2019 CyberSource Global Payment Management for Magento 2 14

Figure 28 CyberSource Business Center Secure Acceptance Profiles Configuration - Notifications Set-tings

The Merchant POST URL is ltyour base urlgt + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Merchant POST URL would behttpwwwexamplecomcybersourceindexplaceOrder

When you configure a Merchant POST URL you will also see additional settings for the card digitsreturned and stored in Magento

217 Customer Response

Response pages are URLrsquos that customers get directed to when a transaction is completed or has beencancelled

Oct 07 2019 CyberSource Global Payment Management for Magento 2 15

Figure 29 CyberSource Business Center Secure Acceptance Profiles Configuration - Customer ResponseConfiguration

Your Transaction Response page URL is your base url + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexplaceOrder

Your Custom Cancel Response Page URL is your base url + cybersourceindexcancel

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexcancel

Oct 07 2019 CyberSource Global Payment Management for Magento 2 16

218 Branding

In this section you can customize look and feel of the Hosted Checkout page It doesnrsquot affect Magentointegration directly These settings are not applicable for the Secure Acceptance Checkout API (SilentOrder POST)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 17

22 Decision Manager

For the purposes of configuring Magento to work with Decision Manager the following sections out-line some brief topics that help describe how Magento and Decision Manger will work together

221 Orders

When enabled Decision Manager runs in real time with the Authorization The possible decisions areACCEPT REJECT REVIEW or ERROR Orders set to REVIEW by Decision Manager will be marked asPending Review in Magento

When you change an order in Decision Manager Case Management from REVIEW to REJECT or AC-CEPT Magento will not immediately learn of this change Magento will learn of any changes to pay-ment transaction states periodically (by cron every 2 minutes) by contacting CyberSource and query-ing for changes Section 36 describes how you configure Magento Cron settings that will trigger aMagento task that will look for Decision Manager changes and update Magento Orders accordingly

If a change in state is detected the module will update the order status in Magento from PendingReview to one of these states Processing Pending Payment or Closed

Please note that if an order is Pending Review in Decision Manager you cannot prepare an invoice inMagento until it is accepted in Decision Manager

222 Refunds

Please note the order must be either Accepted or Rejected in Decision Manager before you are ableto issue a refund Rejecting an order in Decision Manager will automatically perform an AuthorizationReversal for the order as part of the Cron process that queries CyberSource for updates in DecisionManager

223 Custom Fields

Decision Manager supports up to 100 custom fields called Merchant Defined Data Fields The Cy-berSource Module for Magento 2 will send ten of these fields but they must be configured insideDecision Manager in order to make use of them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 18

Figure 210 CyberSource Business Center Decision Manager Custom Fields Configuration

To add the additional custom fields provided by Magento 2 login to the Business Center and navigateto Decision Manager gt Shared Configuration gt Custom Fields Use the tables below to configure thefields

To add a field click the Add Custom Field button select the Order Element and input the name Followthe table below to map the correct element and name

Field Name Order ElementLogged in customer merchant_defined_data1Account creation date merchant_defined_data2Purchase History Count merchant_defined_data3Last Order Date merchant_defined_data4Member account age merchant_defined_data5Repeat customer merchant_defined_data6Coupon Code Used merchant_defined_data20Discount Amount merchant_defined_data21Gift Message merchant_defined_data22Order Source merchant_defined_data23Shipping Method Code merchant_defined_data31Shipping Method Description merchant_defined_data32

For complete Decision Manager configuration instructions please refer to the CyberSource DecisionManager User Guide referenced in Section 6 of this manual

Oct 07 2019 CyberSource Global Payment Management for Magento 2 19

23 Security Credentials

In addition to the Secure Acceptance security credentials created in Section 21 the module usesother connection methods to access CyberSource services that require their own security credentialsfor authentication

Note Configuring of SOAP Toolkit Key is mandatory for this extension proper functioning

231 Create a SOAP Toolkit Key

The CyberSource Module for Magento makes use of the SOAP Toolkit API to access several Cyber-Source services that do not include the transmission of card data

To create a SOAP Toolkit API transaction key navigate in the Enterprise Business Center to PaymentConfiguration gt Key Management

1 Click the ldquoGenerate Keyrdquo button

2 Select the ldquoTransaction processingrdquo key type and click ldquoNext Steprdquo

3 Select the ldquoSOAPrdquo as key subtype and click ldquoSubmitrdquo

4 Save the resulting key for purposes of entering in your Magento configuration

Figure 211 Create a Transaction Security Key - Selecting Key Type

Oct 07 2019 CyberSource Global Payment Management for Magento 2 20

Figure 212 Create a Transaction Security Key - Selecting Key Subtype

Figure 213 Create a Transaction Security Key - Generated SOAP Toolkit Key

Oct 07 2019 CyberSource Global Payment Management for Magento 2 21

232 Create a Report Download User

The CyberSourceModule for Magento uses a reporting API that allowsMagento to query CyberSourcefor information about transactions To activate this you must create a separate CyberSource BusinessCenter user with the role of ldquoReport Downloadrdquo

Figure 214 CyberSource Business Center Main Navigation - User Administration

Navigate to the Account Management gt User Administration section of the main navigation Thescreen will show a listing of active users Click the ldquoAdd Userrdquo button The next screen will look likethis

Oct 07 2019 CyberSource Global Payment Management for Magento 2 22

Figure 215 Add New CyberSource Business Center User Screen

Fill out the form and select lsquoReport Downloadrsquo User Role Once you complete the Add User form anemail will be sent to the address used on the form The email will contain a link and a onetime lsquotokenrsquoused to validate the email account Once the token is entered you will be asked to reset the passwordThis password is needed in Section 31 for the lsquoReport Passwordrsquo

Oct 07 2019 CyberSource Global Payment Management for Magento 2 23

24 Backend Setup

Certain CyberSource services supported by the Module require additional backend setup on yourMerchant ID Please contact your CyberSource Account Representative to enable any of the followingservices

1 Payment Tokenization Required by the Module for Credit Card processing

2 Decision Manager

3 Payer Authentication

4 PayPal Express Checkout New credentials are required for Alt Pay connection Additional setupin PayPal is documented in the PayPal guide listed in Section 6 of this document

5 eChecks

6 Online Bank Transfers

7 Tax Calculation

8 Klarna

9 Account Takeover Protection

10 Account Updater

11 Visa Checkout (enabled in the EBC)

12 Apple Pay (enabled in the EBC)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 24

3 Magento Backend Configuration Settings

Once logged into the administration section of your Magento 2 website the configuration panel isfound by navigating to the following screen

Stores gt Configuration gt Sales gt Payment Methods

Once on that screen you will see the settings for the CyberSource module Inside this panel areadditional sub panels

25

Figure 31 Main CyberSource configuration panel with sub panels

Oct 07 2019 CyberSource Global Payment Management for Magento 2 26

31 General Settings

Figure 32 General Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 27

Figure 33 General Settings (continued)

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of Secure Acceptance

payment method for credit cards This is used for both Web Mobileand Silent Order Post configurations

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 28

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 5: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

1 Introduction

The purpose of this manual is to guide a user through the configuration settings and use of theCyberSource Global Payment Management Extension for the Magento 2x ecommerce platform

Where appropriate this manual will reference documentation produced by CyberSource

The CyberSource Global Payment Management Extension for Magento 2 includes the following Cy-berSource payment management capabilities

11 Payment Tokenization with Secure Acceptance

The CyberSource extension for Magento uses Secure Acceptance to securely collect sensitive carddata from the consumerrsquos browser Secure Acceptance prevents sensitive payment data from evertouching your systems to reduce your overall PCI scope potentially allowing merchants to qualify forthe SAQ A or SAQ A-EP

The extension also incorporates CyberSource Tokenization which replaces sensitive payment trans-action data with a unique identifier that cannot be reverse-engineered The unique identifier is calleda payment token (also known as a Profile ID or Subscription ID) which is stored in Magento and takesthe place of sensitive cardholder information allowing your operations to run without sensitive carddata in your environment

12 Credit Card Services

The CyberSource Magento extension includes the following credit card services

bull Authorization

bull Sale (Authorization + Capture)

bull Authorization Reversal

bull Capture

bull Credit

bull Void

2

13 Decision Manager

Decision Manager is a fraud management platform that prevents fraud losses and gives you the flexi-bility to control business practices and policies in real time With DecisionManager you can accuratelyidentify and review potentially risky transactions while minimizing the rejection of valid orders

The CyberSource Magento extension includes

bull Real-time fraud screening performed during Authorization

bull Device Fingerprinting

bull On-Demand Conversion Detail Report for changes in order status

14 Account Takeover Protection

CyberSource Account Takeover Protection defends consumers and merchants from fraudulent usesof online accounts It helps identify high risk users at account creation and login and monitors forsuspicious account changes

The CyberSource Magento extension includes

bull Real-time event screening account creation login and account changes

bull Device Fingerprinting

15 Payer Authentication (3-D Secure)

CyberSource Payer Authentication services enable you to add support to your web store for cardauthentication services offered by Visa MasterCard and other card brands These programs verifythe cardholderrsquos identity directly with the card issuing bank in real-time to increase payment securityand reduce the risk of fraud however Payer Authentication is not a fraud management service andCyberSource recommends that you implement a comprehensive fraud management program such asDecision Manager in addition to Payer Authentication services

The CyberSource Magento extension includes the following Payer Authentication programs

bull Verified by Visa

bull MasterCard Secure Code

bull American Express SafeKey

bull Discover ProtectBuy

bull JCB

bull Dinners

bull Maestro International

Oct 07 2019 CyberSource Global Payment Management for Magento 2 3

16 PayPal Express Checkout

The CyberSource Extension for Magento includes the PayPal Express Checkout payment method Pro-cessing your PayPal transactions through CyberSource allows you to consolidate all payment typesunder a single gateway account simplify integration efforts screen PayPal transactions for fraud withDecision Manager and streamline reporting

The CyberSource Magento extension supports the following PayPal services

bull Sessions

bull Check Status

bull Order

bull Authorization

bull Authorization Reversal

bull Capture

bull Sale

bull Refund

bull PayPal Credit

bull Billing Agreements

17 Electronic Check (eCheck)

Electronic checks also known as e-checks are a form of digital payment that serves the same functionas a physical check When a merchant accepts an electronic check payment the funds are pulleddirectly from the customerrsquos checking or savings account

The CyberSource Magento extension supports the following e-check services

bull Debit

bull Credit

E-checks will process refunds when you use the credit payment service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 4

18 Online Bank Transfers

Online banking services enable customers to pay for goods by pushingmoney from their bank accountto the merchant

The CyberSource Magento extension supports the following payment methods and correspondingonline bank transfer services

bull Bancontact

ndash Sale

ndash Check Status

ndash Refund

ndash Country Belgium

bull Sofort

ndash Sale

ndash Check Status

ndash Refund

ndash Country many European regions

bull iDEAL

ndash Options

ndash Sale

ndash Check Status

ndash Refund

ndash Country Netherlands

bull EPS

ndash Sale

ndash Check Status

ndash Refund

ndash Country Austria

bull giropay

ndash Sale

ndash Check Status

ndash Country Germany

Oct 07 2019 CyberSource Global Payment Management for Magento 2 5

19 Tax Calculation

The tax calculation service provides real-time tax calculation at the time of checkout for orders placedworldwide with your business

The CyberSource Magento extension supports the Tax calculation service

110 Delivery Address Verification

The Delivery Address Verification service verifies typed addresses and corrects invalid citystateZIPcombinations in real-time

The CyberSourceMagento extension supports the Delivery Address Verification service while updatingshipping information if this feature is enabled in the Magento admin

111 PayPal Credit

PayPal Credit is a payment method allowing merchants to accept a PayPal transaction where thecustomer elects to finance their purchase through PayPal

112 Visa Checkout

Visa Checkout can increase sales conversion by making it easier for your customers to pay with theircard online The CyberSource extension for Magento supports the following services

bull Visa Checkout button

bull Get Visa Checkout Data

bull Authorization

bull Sale (Authorization + Capture)

bull Authorization Reversal

bull Capture

bull Credit

bull Void

113 Klarna

Klarna credit provides a seamless user experience for online consumer financing to merchants ofall sizes increasing consumer choice loyalty and grow sales

The goal of this is to implement Authorize Capture and Refund functionality for this pay-ment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 6

2 CyberSource Configuration

Before configuring Magento the CyberSource Enterprise Business Center needs to be configured

Customer payments are managed by both Magento and the CyberSource Enterprise Business Center(EBC) This section covers the mandatory settings that must be configured in the EBC as well as somegeneral use cases that will be typical in the day to day management of your Magento store

Merchants will need to contact CyberSource Customer Support for product availability and enable-ment

21 Secure Acceptance Configuration

To start profile configuration visit the CyberSource Business Center by following one of these URLrsquos

Testing URL httpsebctestcybersourcecomebc2

Production URL httpsebccybersourcecomebc2

In the left navigation panel choose Payment Configuration gt Secure Acceptance Settings

Once on that panel choose the button in the top right labeled Create New Profile

Figure 21 CyberSource Business Center Secure Acceptance Profiles Configuration - New Profile button

7

211 Create New Profile

A Magento instance can have many Secure Acceptance Profiles but you need at least one The Profilewill hold settings related to the cards you accept the currency and other settings including the ProfileID and Security Access Keys needed by Magento to communicate with CyberSource

Figure 22 below shows the profile creation screen Secure Acceptance is offered in two differentmodes

bull Hosted Checkout (formerlyWebMobile) is a hosted payment page available in iframe or redirectmethod

bull Checkout API (formerly Silent Order POST (SOP)) directly posts card data from your customersrsquobrowser to CyberSource The customer never leaves your site and your site never receives anycard data which reduces PCI DSS scope

Ensure you select either the Hosted Checkout or Checkout API Integration Method and select allrelevant checkboxes in the Added Value Services section

Note Payment Tokenization is required for using this extension Decision Manager is optional

Oct 07 2019 CyberSource Global Payment Management for Magento 2 8

Figure 22 CyberSource Business Center Secure Acceptance Profiles Configuration - Create New Profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 9

212 General Settings

Figure 23 CyberSource Business Center Secure Acceptance Profiles Configuration - General Settings

After you have saved the profile you can begin configuring it The first step is General Settings Pleasemake note of the Profile ID This is a key setting needed for Magento See Section 34 and Section 39

Note Payment Tokenization is required

Oct 07 2019 CyberSource Global Payment Management for Magento 2 10

Note Decision Manager and related settings are required only if you use Decision Manager

213 Payment Settings

In this section you can specify which card types are allowed for the payment method You can alsoselect currency CVN Display CVN Required and Payer Authentication options

Note In order to enable PayPal Express Checkout payments just enable and configure it in Magentosettings not here The extension implements PayPal payments natively See Section 310

Oct 07 2019 CyberSource Global Payment Management for Magento 2 11

Figure 24 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Settings

214 Security

In the Security panel you will create an Access Key and a Secret Key needed to complete the setup ofthe Magento 2 Module See Section 34 and Section 39

Oct 07 2019 CyberSource Global Payment Management for Magento 2 12

Figure 25 CyberSource Business Center Secure Acceptance Profiles Configuration - Security Settings

If you still donrsquot have any keys generated click on lsquo+rsquo button and create a new key

Figure 26 CyberSource Business Center Secure Acceptance Profiles Configuration - Key Creation

215 Payment Form

If using Secure Acceptance Hosted Checkout (WebMobile) when a customer is either redirected tothe hosted payment page at CyberSource or if they see the modal popup window during checkoutthey will see a payment form that has been configured with the settings below These settings are notapplicable for the Secure Acceptance Checkout API (Silent Order POST) configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 13

Figure 27 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Form Set-ting

These settings have no effect on the integration with Magento and can be configured to your specificneeds

216 Notifications

On this configuration panel you must choose the Merchant POST URL tick box and input callback URLto your store

Oct 07 2019 CyberSource Global Payment Management for Magento 2 14

Figure 28 CyberSource Business Center Secure Acceptance Profiles Configuration - Notifications Set-tings

The Merchant POST URL is ltyour base urlgt + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Merchant POST URL would behttpwwwexamplecomcybersourceindexplaceOrder

When you configure a Merchant POST URL you will also see additional settings for the card digitsreturned and stored in Magento

217 Customer Response

Response pages are URLrsquos that customers get directed to when a transaction is completed or has beencancelled

Oct 07 2019 CyberSource Global Payment Management for Magento 2 15

Figure 29 CyberSource Business Center Secure Acceptance Profiles Configuration - Customer ResponseConfiguration

Your Transaction Response page URL is your base url + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexplaceOrder

Your Custom Cancel Response Page URL is your base url + cybersourceindexcancel

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexcancel

Oct 07 2019 CyberSource Global Payment Management for Magento 2 16

218 Branding

In this section you can customize look and feel of the Hosted Checkout page It doesnrsquot affect Magentointegration directly These settings are not applicable for the Secure Acceptance Checkout API (SilentOrder POST)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 17

22 Decision Manager

For the purposes of configuring Magento to work with Decision Manager the following sections out-line some brief topics that help describe how Magento and Decision Manger will work together

221 Orders

When enabled Decision Manager runs in real time with the Authorization The possible decisions areACCEPT REJECT REVIEW or ERROR Orders set to REVIEW by Decision Manager will be marked asPending Review in Magento

When you change an order in Decision Manager Case Management from REVIEW to REJECT or AC-CEPT Magento will not immediately learn of this change Magento will learn of any changes to pay-ment transaction states periodically (by cron every 2 minutes) by contacting CyberSource and query-ing for changes Section 36 describes how you configure Magento Cron settings that will trigger aMagento task that will look for Decision Manager changes and update Magento Orders accordingly

If a change in state is detected the module will update the order status in Magento from PendingReview to one of these states Processing Pending Payment or Closed

Please note that if an order is Pending Review in Decision Manager you cannot prepare an invoice inMagento until it is accepted in Decision Manager

222 Refunds

Please note the order must be either Accepted or Rejected in Decision Manager before you are ableto issue a refund Rejecting an order in Decision Manager will automatically perform an AuthorizationReversal for the order as part of the Cron process that queries CyberSource for updates in DecisionManager

223 Custom Fields

Decision Manager supports up to 100 custom fields called Merchant Defined Data Fields The Cy-berSource Module for Magento 2 will send ten of these fields but they must be configured insideDecision Manager in order to make use of them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 18

Figure 210 CyberSource Business Center Decision Manager Custom Fields Configuration

To add the additional custom fields provided by Magento 2 login to the Business Center and navigateto Decision Manager gt Shared Configuration gt Custom Fields Use the tables below to configure thefields

To add a field click the Add Custom Field button select the Order Element and input the name Followthe table below to map the correct element and name

Field Name Order ElementLogged in customer merchant_defined_data1Account creation date merchant_defined_data2Purchase History Count merchant_defined_data3Last Order Date merchant_defined_data4Member account age merchant_defined_data5Repeat customer merchant_defined_data6Coupon Code Used merchant_defined_data20Discount Amount merchant_defined_data21Gift Message merchant_defined_data22Order Source merchant_defined_data23Shipping Method Code merchant_defined_data31Shipping Method Description merchant_defined_data32

For complete Decision Manager configuration instructions please refer to the CyberSource DecisionManager User Guide referenced in Section 6 of this manual

Oct 07 2019 CyberSource Global Payment Management for Magento 2 19

23 Security Credentials

In addition to the Secure Acceptance security credentials created in Section 21 the module usesother connection methods to access CyberSource services that require their own security credentialsfor authentication

Note Configuring of SOAP Toolkit Key is mandatory for this extension proper functioning

231 Create a SOAP Toolkit Key

The CyberSource Module for Magento makes use of the SOAP Toolkit API to access several Cyber-Source services that do not include the transmission of card data

To create a SOAP Toolkit API transaction key navigate in the Enterprise Business Center to PaymentConfiguration gt Key Management

1 Click the ldquoGenerate Keyrdquo button

2 Select the ldquoTransaction processingrdquo key type and click ldquoNext Steprdquo

3 Select the ldquoSOAPrdquo as key subtype and click ldquoSubmitrdquo

4 Save the resulting key for purposes of entering in your Magento configuration

Figure 211 Create a Transaction Security Key - Selecting Key Type

Oct 07 2019 CyberSource Global Payment Management for Magento 2 20

Figure 212 Create a Transaction Security Key - Selecting Key Subtype

Figure 213 Create a Transaction Security Key - Generated SOAP Toolkit Key

Oct 07 2019 CyberSource Global Payment Management for Magento 2 21

232 Create a Report Download User

The CyberSourceModule for Magento uses a reporting API that allowsMagento to query CyberSourcefor information about transactions To activate this you must create a separate CyberSource BusinessCenter user with the role of ldquoReport Downloadrdquo

Figure 214 CyberSource Business Center Main Navigation - User Administration

Navigate to the Account Management gt User Administration section of the main navigation Thescreen will show a listing of active users Click the ldquoAdd Userrdquo button The next screen will look likethis

Oct 07 2019 CyberSource Global Payment Management for Magento 2 22

Figure 215 Add New CyberSource Business Center User Screen

Fill out the form and select lsquoReport Downloadrsquo User Role Once you complete the Add User form anemail will be sent to the address used on the form The email will contain a link and a onetime lsquotokenrsquoused to validate the email account Once the token is entered you will be asked to reset the passwordThis password is needed in Section 31 for the lsquoReport Passwordrsquo

Oct 07 2019 CyberSource Global Payment Management for Magento 2 23

24 Backend Setup

Certain CyberSource services supported by the Module require additional backend setup on yourMerchant ID Please contact your CyberSource Account Representative to enable any of the followingservices

1 Payment Tokenization Required by the Module for Credit Card processing

2 Decision Manager

3 Payer Authentication

4 PayPal Express Checkout New credentials are required for Alt Pay connection Additional setupin PayPal is documented in the PayPal guide listed in Section 6 of this document

5 eChecks

6 Online Bank Transfers

7 Tax Calculation

8 Klarna

9 Account Takeover Protection

10 Account Updater

11 Visa Checkout (enabled in the EBC)

12 Apple Pay (enabled in the EBC)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 24

3 Magento Backend Configuration Settings

Once logged into the administration section of your Magento 2 website the configuration panel isfound by navigating to the following screen

Stores gt Configuration gt Sales gt Payment Methods

Once on that screen you will see the settings for the CyberSource module Inside this panel areadditional sub panels

25

Figure 31 Main CyberSource configuration panel with sub panels

Oct 07 2019 CyberSource Global Payment Management for Magento 2 26

31 General Settings

Figure 32 General Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 27

Figure 33 General Settings (continued)

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of Secure Acceptance

payment method for credit cards This is used for both Web Mobileand Silent Order Post configurations

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 28

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 6: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

13 Decision Manager

Decision Manager is a fraud management platform that prevents fraud losses and gives you the flexi-bility to control business practices and policies in real time With DecisionManager you can accuratelyidentify and review potentially risky transactions while minimizing the rejection of valid orders

The CyberSource Magento extension includes

bull Real-time fraud screening performed during Authorization

bull Device Fingerprinting

bull On-Demand Conversion Detail Report for changes in order status

14 Account Takeover Protection

CyberSource Account Takeover Protection defends consumers and merchants from fraudulent usesof online accounts It helps identify high risk users at account creation and login and monitors forsuspicious account changes

The CyberSource Magento extension includes

bull Real-time event screening account creation login and account changes

bull Device Fingerprinting

15 Payer Authentication (3-D Secure)

CyberSource Payer Authentication services enable you to add support to your web store for cardauthentication services offered by Visa MasterCard and other card brands These programs verifythe cardholderrsquos identity directly with the card issuing bank in real-time to increase payment securityand reduce the risk of fraud however Payer Authentication is not a fraud management service andCyberSource recommends that you implement a comprehensive fraud management program such asDecision Manager in addition to Payer Authentication services

The CyberSource Magento extension includes the following Payer Authentication programs

bull Verified by Visa

bull MasterCard Secure Code

bull American Express SafeKey

bull Discover ProtectBuy

bull JCB

bull Dinners

bull Maestro International

Oct 07 2019 CyberSource Global Payment Management for Magento 2 3

16 PayPal Express Checkout

The CyberSource Extension for Magento includes the PayPal Express Checkout payment method Pro-cessing your PayPal transactions through CyberSource allows you to consolidate all payment typesunder a single gateway account simplify integration efforts screen PayPal transactions for fraud withDecision Manager and streamline reporting

The CyberSource Magento extension supports the following PayPal services

bull Sessions

bull Check Status

bull Order

bull Authorization

bull Authorization Reversal

bull Capture

bull Sale

bull Refund

bull PayPal Credit

bull Billing Agreements

17 Electronic Check (eCheck)

Electronic checks also known as e-checks are a form of digital payment that serves the same functionas a physical check When a merchant accepts an electronic check payment the funds are pulleddirectly from the customerrsquos checking or savings account

The CyberSource Magento extension supports the following e-check services

bull Debit

bull Credit

E-checks will process refunds when you use the credit payment service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 4

18 Online Bank Transfers

Online banking services enable customers to pay for goods by pushingmoney from their bank accountto the merchant

The CyberSource Magento extension supports the following payment methods and correspondingonline bank transfer services

bull Bancontact

ndash Sale

ndash Check Status

ndash Refund

ndash Country Belgium

bull Sofort

ndash Sale

ndash Check Status

ndash Refund

ndash Country many European regions

bull iDEAL

ndash Options

ndash Sale

ndash Check Status

ndash Refund

ndash Country Netherlands

bull EPS

ndash Sale

ndash Check Status

ndash Refund

ndash Country Austria

bull giropay

ndash Sale

ndash Check Status

ndash Country Germany

Oct 07 2019 CyberSource Global Payment Management for Magento 2 5

19 Tax Calculation

The tax calculation service provides real-time tax calculation at the time of checkout for orders placedworldwide with your business

The CyberSource Magento extension supports the Tax calculation service

110 Delivery Address Verification

The Delivery Address Verification service verifies typed addresses and corrects invalid citystateZIPcombinations in real-time

The CyberSourceMagento extension supports the Delivery Address Verification service while updatingshipping information if this feature is enabled in the Magento admin

111 PayPal Credit

PayPal Credit is a payment method allowing merchants to accept a PayPal transaction where thecustomer elects to finance their purchase through PayPal

112 Visa Checkout

Visa Checkout can increase sales conversion by making it easier for your customers to pay with theircard online The CyberSource extension for Magento supports the following services

bull Visa Checkout button

bull Get Visa Checkout Data

bull Authorization

bull Sale (Authorization + Capture)

bull Authorization Reversal

bull Capture

bull Credit

bull Void

113 Klarna

Klarna credit provides a seamless user experience for online consumer financing to merchants ofall sizes increasing consumer choice loyalty and grow sales

The goal of this is to implement Authorize Capture and Refund functionality for this pay-ment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 6

2 CyberSource Configuration

Before configuring Magento the CyberSource Enterprise Business Center needs to be configured

Customer payments are managed by both Magento and the CyberSource Enterprise Business Center(EBC) This section covers the mandatory settings that must be configured in the EBC as well as somegeneral use cases that will be typical in the day to day management of your Magento store

Merchants will need to contact CyberSource Customer Support for product availability and enable-ment

21 Secure Acceptance Configuration

To start profile configuration visit the CyberSource Business Center by following one of these URLrsquos

Testing URL httpsebctestcybersourcecomebc2

Production URL httpsebccybersourcecomebc2

In the left navigation panel choose Payment Configuration gt Secure Acceptance Settings

Once on that panel choose the button in the top right labeled Create New Profile

Figure 21 CyberSource Business Center Secure Acceptance Profiles Configuration - New Profile button

7

211 Create New Profile

A Magento instance can have many Secure Acceptance Profiles but you need at least one The Profilewill hold settings related to the cards you accept the currency and other settings including the ProfileID and Security Access Keys needed by Magento to communicate with CyberSource

Figure 22 below shows the profile creation screen Secure Acceptance is offered in two differentmodes

bull Hosted Checkout (formerlyWebMobile) is a hosted payment page available in iframe or redirectmethod

bull Checkout API (formerly Silent Order POST (SOP)) directly posts card data from your customersrsquobrowser to CyberSource The customer never leaves your site and your site never receives anycard data which reduces PCI DSS scope

Ensure you select either the Hosted Checkout or Checkout API Integration Method and select allrelevant checkboxes in the Added Value Services section

Note Payment Tokenization is required for using this extension Decision Manager is optional

Oct 07 2019 CyberSource Global Payment Management for Magento 2 8

Figure 22 CyberSource Business Center Secure Acceptance Profiles Configuration - Create New Profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 9

212 General Settings

Figure 23 CyberSource Business Center Secure Acceptance Profiles Configuration - General Settings

After you have saved the profile you can begin configuring it The first step is General Settings Pleasemake note of the Profile ID This is a key setting needed for Magento See Section 34 and Section 39

Note Payment Tokenization is required

Oct 07 2019 CyberSource Global Payment Management for Magento 2 10

Note Decision Manager and related settings are required only if you use Decision Manager

213 Payment Settings

In this section you can specify which card types are allowed for the payment method You can alsoselect currency CVN Display CVN Required and Payer Authentication options

Note In order to enable PayPal Express Checkout payments just enable and configure it in Magentosettings not here The extension implements PayPal payments natively See Section 310

Oct 07 2019 CyberSource Global Payment Management for Magento 2 11

Figure 24 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Settings

214 Security

In the Security panel you will create an Access Key and a Secret Key needed to complete the setup ofthe Magento 2 Module See Section 34 and Section 39

Oct 07 2019 CyberSource Global Payment Management for Magento 2 12

Figure 25 CyberSource Business Center Secure Acceptance Profiles Configuration - Security Settings

If you still donrsquot have any keys generated click on lsquo+rsquo button and create a new key

Figure 26 CyberSource Business Center Secure Acceptance Profiles Configuration - Key Creation

215 Payment Form

If using Secure Acceptance Hosted Checkout (WebMobile) when a customer is either redirected tothe hosted payment page at CyberSource or if they see the modal popup window during checkoutthey will see a payment form that has been configured with the settings below These settings are notapplicable for the Secure Acceptance Checkout API (Silent Order POST) configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 13

Figure 27 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Form Set-ting

These settings have no effect on the integration with Magento and can be configured to your specificneeds

216 Notifications

On this configuration panel you must choose the Merchant POST URL tick box and input callback URLto your store

Oct 07 2019 CyberSource Global Payment Management for Magento 2 14

Figure 28 CyberSource Business Center Secure Acceptance Profiles Configuration - Notifications Set-tings

The Merchant POST URL is ltyour base urlgt + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Merchant POST URL would behttpwwwexamplecomcybersourceindexplaceOrder

When you configure a Merchant POST URL you will also see additional settings for the card digitsreturned and stored in Magento

217 Customer Response

Response pages are URLrsquos that customers get directed to when a transaction is completed or has beencancelled

Oct 07 2019 CyberSource Global Payment Management for Magento 2 15

Figure 29 CyberSource Business Center Secure Acceptance Profiles Configuration - Customer ResponseConfiguration

Your Transaction Response page URL is your base url + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexplaceOrder

Your Custom Cancel Response Page URL is your base url + cybersourceindexcancel

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexcancel

Oct 07 2019 CyberSource Global Payment Management for Magento 2 16

218 Branding

In this section you can customize look and feel of the Hosted Checkout page It doesnrsquot affect Magentointegration directly These settings are not applicable for the Secure Acceptance Checkout API (SilentOrder POST)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 17

22 Decision Manager

For the purposes of configuring Magento to work with Decision Manager the following sections out-line some brief topics that help describe how Magento and Decision Manger will work together

221 Orders

When enabled Decision Manager runs in real time with the Authorization The possible decisions areACCEPT REJECT REVIEW or ERROR Orders set to REVIEW by Decision Manager will be marked asPending Review in Magento

When you change an order in Decision Manager Case Management from REVIEW to REJECT or AC-CEPT Magento will not immediately learn of this change Magento will learn of any changes to pay-ment transaction states periodically (by cron every 2 minutes) by contacting CyberSource and query-ing for changes Section 36 describes how you configure Magento Cron settings that will trigger aMagento task that will look for Decision Manager changes and update Magento Orders accordingly

If a change in state is detected the module will update the order status in Magento from PendingReview to one of these states Processing Pending Payment or Closed

Please note that if an order is Pending Review in Decision Manager you cannot prepare an invoice inMagento until it is accepted in Decision Manager

222 Refunds

Please note the order must be either Accepted or Rejected in Decision Manager before you are ableto issue a refund Rejecting an order in Decision Manager will automatically perform an AuthorizationReversal for the order as part of the Cron process that queries CyberSource for updates in DecisionManager

223 Custom Fields

Decision Manager supports up to 100 custom fields called Merchant Defined Data Fields The Cy-berSource Module for Magento 2 will send ten of these fields but they must be configured insideDecision Manager in order to make use of them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 18

Figure 210 CyberSource Business Center Decision Manager Custom Fields Configuration

To add the additional custom fields provided by Magento 2 login to the Business Center and navigateto Decision Manager gt Shared Configuration gt Custom Fields Use the tables below to configure thefields

To add a field click the Add Custom Field button select the Order Element and input the name Followthe table below to map the correct element and name

Field Name Order ElementLogged in customer merchant_defined_data1Account creation date merchant_defined_data2Purchase History Count merchant_defined_data3Last Order Date merchant_defined_data4Member account age merchant_defined_data5Repeat customer merchant_defined_data6Coupon Code Used merchant_defined_data20Discount Amount merchant_defined_data21Gift Message merchant_defined_data22Order Source merchant_defined_data23Shipping Method Code merchant_defined_data31Shipping Method Description merchant_defined_data32

For complete Decision Manager configuration instructions please refer to the CyberSource DecisionManager User Guide referenced in Section 6 of this manual

Oct 07 2019 CyberSource Global Payment Management for Magento 2 19

23 Security Credentials

In addition to the Secure Acceptance security credentials created in Section 21 the module usesother connection methods to access CyberSource services that require their own security credentialsfor authentication

Note Configuring of SOAP Toolkit Key is mandatory for this extension proper functioning

231 Create a SOAP Toolkit Key

The CyberSource Module for Magento makes use of the SOAP Toolkit API to access several Cyber-Source services that do not include the transmission of card data

To create a SOAP Toolkit API transaction key navigate in the Enterprise Business Center to PaymentConfiguration gt Key Management

1 Click the ldquoGenerate Keyrdquo button

2 Select the ldquoTransaction processingrdquo key type and click ldquoNext Steprdquo

3 Select the ldquoSOAPrdquo as key subtype and click ldquoSubmitrdquo

4 Save the resulting key for purposes of entering in your Magento configuration

Figure 211 Create a Transaction Security Key - Selecting Key Type

Oct 07 2019 CyberSource Global Payment Management for Magento 2 20

Figure 212 Create a Transaction Security Key - Selecting Key Subtype

Figure 213 Create a Transaction Security Key - Generated SOAP Toolkit Key

Oct 07 2019 CyberSource Global Payment Management for Magento 2 21

232 Create a Report Download User

The CyberSourceModule for Magento uses a reporting API that allowsMagento to query CyberSourcefor information about transactions To activate this you must create a separate CyberSource BusinessCenter user with the role of ldquoReport Downloadrdquo

Figure 214 CyberSource Business Center Main Navigation - User Administration

Navigate to the Account Management gt User Administration section of the main navigation Thescreen will show a listing of active users Click the ldquoAdd Userrdquo button The next screen will look likethis

Oct 07 2019 CyberSource Global Payment Management for Magento 2 22

Figure 215 Add New CyberSource Business Center User Screen

Fill out the form and select lsquoReport Downloadrsquo User Role Once you complete the Add User form anemail will be sent to the address used on the form The email will contain a link and a onetime lsquotokenrsquoused to validate the email account Once the token is entered you will be asked to reset the passwordThis password is needed in Section 31 for the lsquoReport Passwordrsquo

Oct 07 2019 CyberSource Global Payment Management for Magento 2 23

24 Backend Setup

Certain CyberSource services supported by the Module require additional backend setup on yourMerchant ID Please contact your CyberSource Account Representative to enable any of the followingservices

1 Payment Tokenization Required by the Module for Credit Card processing

2 Decision Manager

3 Payer Authentication

4 PayPal Express Checkout New credentials are required for Alt Pay connection Additional setupin PayPal is documented in the PayPal guide listed in Section 6 of this document

5 eChecks

6 Online Bank Transfers

7 Tax Calculation

8 Klarna

9 Account Takeover Protection

10 Account Updater

11 Visa Checkout (enabled in the EBC)

12 Apple Pay (enabled in the EBC)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 24

3 Magento Backend Configuration Settings

Once logged into the administration section of your Magento 2 website the configuration panel isfound by navigating to the following screen

Stores gt Configuration gt Sales gt Payment Methods

Once on that screen you will see the settings for the CyberSource module Inside this panel areadditional sub panels

25

Figure 31 Main CyberSource configuration panel with sub panels

Oct 07 2019 CyberSource Global Payment Management for Magento 2 26

31 General Settings

Figure 32 General Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 27

Figure 33 General Settings (continued)

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of Secure Acceptance

payment method for credit cards This is used for both Web Mobileand Silent Order Post configurations

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 28

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 7: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

16 PayPal Express Checkout

The CyberSource Extension for Magento includes the PayPal Express Checkout payment method Pro-cessing your PayPal transactions through CyberSource allows you to consolidate all payment typesunder a single gateway account simplify integration efforts screen PayPal transactions for fraud withDecision Manager and streamline reporting

The CyberSource Magento extension supports the following PayPal services

bull Sessions

bull Check Status

bull Order

bull Authorization

bull Authorization Reversal

bull Capture

bull Sale

bull Refund

bull PayPal Credit

bull Billing Agreements

17 Electronic Check (eCheck)

Electronic checks also known as e-checks are a form of digital payment that serves the same functionas a physical check When a merchant accepts an electronic check payment the funds are pulleddirectly from the customerrsquos checking or savings account

The CyberSource Magento extension supports the following e-check services

bull Debit

bull Credit

E-checks will process refunds when you use the credit payment service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 4

18 Online Bank Transfers

Online banking services enable customers to pay for goods by pushingmoney from their bank accountto the merchant

The CyberSource Magento extension supports the following payment methods and correspondingonline bank transfer services

bull Bancontact

ndash Sale

ndash Check Status

ndash Refund

ndash Country Belgium

bull Sofort

ndash Sale

ndash Check Status

ndash Refund

ndash Country many European regions

bull iDEAL

ndash Options

ndash Sale

ndash Check Status

ndash Refund

ndash Country Netherlands

bull EPS

ndash Sale

ndash Check Status

ndash Refund

ndash Country Austria

bull giropay

ndash Sale

ndash Check Status

ndash Country Germany

Oct 07 2019 CyberSource Global Payment Management for Magento 2 5

19 Tax Calculation

The tax calculation service provides real-time tax calculation at the time of checkout for orders placedworldwide with your business

The CyberSource Magento extension supports the Tax calculation service

110 Delivery Address Verification

The Delivery Address Verification service verifies typed addresses and corrects invalid citystateZIPcombinations in real-time

The CyberSourceMagento extension supports the Delivery Address Verification service while updatingshipping information if this feature is enabled in the Magento admin

111 PayPal Credit

PayPal Credit is a payment method allowing merchants to accept a PayPal transaction where thecustomer elects to finance their purchase through PayPal

112 Visa Checkout

Visa Checkout can increase sales conversion by making it easier for your customers to pay with theircard online The CyberSource extension for Magento supports the following services

bull Visa Checkout button

bull Get Visa Checkout Data

bull Authorization

bull Sale (Authorization + Capture)

bull Authorization Reversal

bull Capture

bull Credit

bull Void

113 Klarna

Klarna credit provides a seamless user experience for online consumer financing to merchants ofall sizes increasing consumer choice loyalty and grow sales

The goal of this is to implement Authorize Capture and Refund functionality for this pay-ment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 6

2 CyberSource Configuration

Before configuring Magento the CyberSource Enterprise Business Center needs to be configured

Customer payments are managed by both Magento and the CyberSource Enterprise Business Center(EBC) This section covers the mandatory settings that must be configured in the EBC as well as somegeneral use cases that will be typical in the day to day management of your Magento store

Merchants will need to contact CyberSource Customer Support for product availability and enable-ment

21 Secure Acceptance Configuration

To start profile configuration visit the CyberSource Business Center by following one of these URLrsquos

Testing URL httpsebctestcybersourcecomebc2

Production URL httpsebccybersourcecomebc2

In the left navigation panel choose Payment Configuration gt Secure Acceptance Settings

Once on that panel choose the button in the top right labeled Create New Profile

Figure 21 CyberSource Business Center Secure Acceptance Profiles Configuration - New Profile button

7

211 Create New Profile

A Magento instance can have many Secure Acceptance Profiles but you need at least one The Profilewill hold settings related to the cards you accept the currency and other settings including the ProfileID and Security Access Keys needed by Magento to communicate with CyberSource

Figure 22 below shows the profile creation screen Secure Acceptance is offered in two differentmodes

bull Hosted Checkout (formerlyWebMobile) is a hosted payment page available in iframe or redirectmethod

bull Checkout API (formerly Silent Order POST (SOP)) directly posts card data from your customersrsquobrowser to CyberSource The customer never leaves your site and your site never receives anycard data which reduces PCI DSS scope

Ensure you select either the Hosted Checkout or Checkout API Integration Method and select allrelevant checkboxes in the Added Value Services section

Note Payment Tokenization is required for using this extension Decision Manager is optional

Oct 07 2019 CyberSource Global Payment Management for Magento 2 8

Figure 22 CyberSource Business Center Secure Acceptance Profiles Configuration - Create New Profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 9

212 General Settings

Figure 23 CyberSource Business Center Secure Acceptance Profiles Configuration - General Settings

After you have saved the profile you can begin configuring it The first step is General Settings Pleasemake note of the Profile ID This is a key setting needed for Magento See Section 34 and Section 39

Note Payment Tokenization is required

Oct 07 2019 CyberSource Global Payment Management for Magento 2 10

Note Decision Manager and related settings are required only if you use Decision Manager

213 Payment Settings

In this section you can specify which card types are allowed for the payment method You can alsoselect currency CVN Display CVN Required and Payer Authentication options

Note In order to enable PayPal Express Checkout payments just enable and configure it in Magentosettings not here The extension implements PayPal payments natively See Section 310

Oct 07 2019 CyberSource Global Payment Management for Magento 2 11

Figure 24 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Settings

214 Security

In the Security panel you will create an Access Key and a Secret Key needed to complete the setup ofthe Magento 2 Module See Section 34 and Section 39

Oct 07 2019 CyberSource Global Payment Management for Magento 2 12

Figure 25 CyberSource Business Center Secure Acceptance Profiles Configuration - Security Settings

If you still donrsquot have any keys generated click on lsquo+rsquo button and create a new key

Figure 26 CyberSource Business Center Secure Acceptance Profiles Configuration - Key Creation

215 Payment Form

If using Secure Acceptance Hosted Checkout (WebMobile) when a customer is either redirected tothe hosted payment page at CyberSource or if they see the modal popup window during checkoutthey will see a payment form that has been configured with the settings below These settings are notapplicable for the Secure Acceptance Checkout API (Silent Order POST) configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 13

Figure 27 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Form Set-ting

These settings have no effect on the integration with Magento and can be configured to your specificneeds

216 Notifications

On this configuration panel you must choose the Merchant POST URL tick box and input callback URLto your store

Oct 07 2019 CyberSource Global Payment Management for Magento 2 14

Figure 28 CyberSource Business Center Secure Acceptance Profiles Configuration - Notifications Set-tings

The Merchant POST URL is ltyour base urlgt + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Merchant POST URL would behttpwwwexamplecomcybersourceindexplaceOrder

When you configure a Merchant POST URL you will also see additional settings for the card digitsreturned and stored in Magento

217 Customer Response

Response pages are URLrsquos that customers get directed to when a transaction is completed or has beencancelled

Oct 07 2019 CyberSource Global Payment Management for Magento 2 15

Figure 29 CyberSource Business Center Secure Acceptance Profiles Configuration - Customer ResponseConfiguration

Your Transaction Response page URL is your base url + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexplaceOrder

Your Custom Cancel Response Page URL is your base url + cybersourceindexcancel

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexcancel

Oct 07 2019 CyberSource Global Payment Management for Magento 2 16

218 Branding

In this section you can customize look and feel of the Hosted Checkout page It doesnrsquot affect Magentointegration directly These settings are not applicable for the Secure Acceptance Checkout API (SilentOrder POST)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 17

22 Decision Manager

For the purposes of configuring Magento to work with Decision Manager the following sections out-line some brief topics that help describe how Magento and Decision Manger will work together

221 Orders

When enabled Decision Manager runs in real time with the Authorization The possible decisions areACCEPT REJECT REVIEW or ERROR Orders set to REVIEW by Decision Manager will be marked asPending Review in Magento

When you change an order in Decision Manager Case Management from REVIEW to REJECT or AC-CEPT Magento will not immediately learn of this change Magento will learn of any changes to pay-ment transaction states periodically (by cron every 2 minutes) by contacting CyberSource and query-ing for changes Section 36 describes how you configure Magento Cron settings that will trigger aMagento task that will look for Decision Manager changes and update Magento Orders accordingly

If a change in state is detected the module will update the order status in Magento from PendingReview to one of these states Processing Pending Payment or Closed

Please note that if an order is Pending Review in Decision Manager you cannot prepare an invoice inMagento until it is accepted in Decision Manager

222 Refunds

Please note the order must be either Accepted or Rejected in Decision Manager before you are ableto issue a refund Rejecting an order in Decision Manager will automatically perform an AuthorizationReversal for the order as part of the Cron process that queries CyberSource for updates in DecisionManager

223 Custom Fields

Decision Manager supports up to 100 custom fields called Merchant Defined Data Fields The Cy-berSource Module for Magento 2 will send ten of these fields but they must be configured insideDecision Manager in order to make use of them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 18

Figure 210 CyberSource Business Center Decision Manager Custom Fields Configuration

To add the additional custom fields provided by Magento 2 login to the Business Center and navigateto Decision Manager gt Shared Configuration gt Custom Fields Use the tables below to configure thefields

To add a field click the Add Custom Field button select the Order Element and input the name Followthe table below to map the correct element and name

Field Name Order ElementLogged in customer merchant_defined_data1Account creation date merchant_defined_data2Purchase History Count merchant_defined_data3Last Order Date merchant_defined_data4Member account age merchant_defined_data5Repeat customer merchant_defined_data6Coupon Code Used merchant_defined_data20Discount Amount merchant_defined_data21Gift Message merchant_defined_data22Order Source merchant_defined_data23Shipping Method Code merchant_defined_data31Shipping Method Description merchant_defined_data32

For complete Decision Manager configuration instructions please refer to the CyberSource DecisionManager User Guide referenced in Section 6 of this manual

Oct 07 2019 CyberSource Global Payment Management for Magento 2 19

23 Security Credentials

In addition to the Secure Acceptance security credentials created in Section 21 the module usesother connection methods to access CyberSource services that require their own security credentialsfor authentication

Note Configuring of SOAP Toolkit Key is mandatory for this extension proper functioning

231 Create a SOAP Toolkit Key

The CyberSource Module for Magento makes use of the SOAP Toolkit API to access several Cyber-Source services that do not include the transmission of card data

To create a SOAP Toolkit API transaction key navigate in the Enterprise Business Center to PaymentConfiguration gt Key Management

1 Click the ldquoGenerate Keyrdquo button

2 Select the ldquoTransaction processingrdquo key type and click ldquoNext Steprdquo

3 Select the ldquoSOAPrdquo as key subtype and click ldquoSubmitrdquo

4 Save the resulting key for purposes of entering in your Magento configuration

Figure 211 Create a Transaction Security Key - Selecting Key Type

Oct 07 2019 CyberSource Global Payment Management for Magento 2 20

Figure 212 Create a Transaction Security Key - Selecting Key Subtype

Figure 213 Create a Transaction Security Key - Generated SOAP Toolkit Key

Oct 07 2019 CyberSource Global Payment Management for Magento 2 21

232 Create a Report Download User

The CyberSourceModule for Magento uses a reporting API that allowsMagento to query CyberSourcefor information about transactions To activate this you must create a separate CyberSource BusinessCenter user with the role of ldquoReport Downloadrdquo

Figure 214 CyberSource Business Center Main Navigation - User Administration

Navigate to the Account Management gt User Administration section of the main navigation Thescreen will show a listing of active users Click the ldquoAdd Userrdquo button The next screen will look likethis

Oct 07 2019 CyberSource Global Payment Management for Magento 2 22

Figure 215 Add New CyberSource Business Center User Screen

Fill out the form and select lsquoReport Downloadrsquo User Role Once you complete the Add User form anemail will be sent to the address used on the form The email will contain a link and a onetime lsquotokenrsquoused to validate the email account Once the token is entered you will be asked to reset the passwordThis password is needed in Section 31 for the lsquoReport Passwordrsquo

Oct 07 2019 CyberSource Global Payment Management for Magento 2 23

24 Backend Setup

Certain CyberSource services supported by the Module require additional backend setup on yourMerchant ID Please contact your CyberSource Account Representative to enable any of the followingservices

1 Payment Tokenization Required by the Module for Credit Card processing

2 Decision Manager

3 Payer Authentication

4 PayPal Express Checkout New credentials are required for Alt Pay connection Additional setupin PayPal is documented in the PayPal guide listed in Section 6 of this document

5 eChecks

6 Online Bank Transfers

7 Tax Calculation

8 Klarna

9 Account Takeover Protection

10 Account Updater

11 Visa Checkout (enabled in the EBC)

12 Apple Pay (enabled in the EBC)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 24

3 Magento Backend Configuration Settings

Once logged into the administration section of your Magento 2 website the configuration panel isfound by navigating to the following screen

Stores gt Configuration gt Sales gt Payment Methods

Once on that screen you will see the settings for the CyberSource module Inside this panel areadditional sub panels

25

Figure 31 Main CyberSource configuration panel with sub panels

Oct 07 2019 CyberSource Global Payment Management for Magento 2 26

31 General Settings

Figure 32 General Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 27

Figure 33 General Settings (continued)

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of Secure Acceptance

payment method for credit cards This is used for both Web Mobileand Silent Order Post configurations

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 28

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 8: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

18 Online Bank Transfers

Online banking services enable customers to pay for goods by pushingmoney from their bank accountto the merchant

The CyberSource Magento extension supports the following payment methods and correspondingonline bank transfer services

bull Bancontact

ndash Sale

ndash Check Status

ndash Refund

ndash Country Belgium

bull Sofort

ndash Sale

ndash Check Status

ndash Refund

ndash Country many European regions

bull iDEAL

ndash Options

ndash Sale

ndash Check Status

ndash Refund

ndash Country Netherlands

bull EPS

ndash Sale

ndash Check Status

ndash Refund

ndash Country Austria

bull giropay

ndash Sale

ndash Check Status

ndash Country Germany

Oct 07 2019 CyberSource Global Payment Management for Magento 2 5

19 Tax Calculation

The tax calculation service provides real-time tax calculation at the time of checkout for orders placedworldwide with your business

The CyberSource Magento extension supports the Tax calculation service

110 Delivery Address Verification

The Delivery Address Verification service verifies typed addresses and corrects invalid citystateZIPcombinations in real-time

The CyberSourceMagento extension supports the Delivery Address Verification service while updatingshipping information if this feature is enabled in the Magento admin

111 PayPal Credit

PayPal Credit is a payment method allowing merchants to accept a PayPal transaction where thecustomer elects to finance their purchase through PayPal

112 Visa Checkout

Visa Checkout can increase sales conversion by making it easier for your customers to pay with theircard online The CyberSource extension for Magento supports the following services

bull Visa Checkout button

bull Get Visa Checkout Data

bull Authorization

bull Sale (Authorization + Capture)

bull Authorization Reversal

bull Capture

bull Credit

bull Void

113 Klarna

Klarna credit provides a seamless user experience for online consumer financing to merchants ofall sizes increasing consumer choice loyalty and grow sales

The goal of this is to implement Authorize Capture and Refund functionality for this pay-ment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 6

2 CyberSource Configuration

Before configuring Magento the CyberSource Enterprise Business Center needs to be configured

Customer payments are managed by both Magento and the CyberSource Enterprise Business Center(EBC) This section covers the mandatory settings that must be configured in the EBC as well as somegeneral use cases that will be typical in the day to day management of your Magento store

Merchants will need to contact CyberSource Customer Support for product availability and enable-ment

21 Secure Acceptance Configuration

To start profile configuration visit the CyberSource Business Center by following one of these URLrsquos

Testing URL httpsebctestcybersourcecomebc2

Production URL httpsebccybersourcecomebc2

In the left navigation panel choose Payment Configuration gt Secure Acceptance Settings

Once on that panel choose the button in the top right labeled Create New Profile

Figure 21 CyberSource Business Center Secure Acceptance Profiles Configuration - New Profile button

7

211 Create New Profile

A Magento instance can have many Secure Acceptance Profiles but you need at least one The Profilewill hold settings related to the cards you accept the currency and other settings including the ProfileID and Security Access Keys needed by Magento to communicate with CyberSource

Figure 22 below shows the profile creation screen Secure Acceptance is offered in two differentmodes

bull Hosted Checkout (formerlyWebMobile) is a hosted payment page available in iframe or redirectmethod

bull Checkout API (formerly Silent Order POST (SOP)) directly posts card data from your customersrsquobrowser to CyberSource The customer never leaves your site and your site never receives anycard data which reduces PCI DSS scope

Ensure you select either the Hosted Checkout or Checkout API Integration Method and select allrelevant checkboxes in the Added Value Services section

Note Payment Tokenization is required for using this extension Decision Manager is optional

Oct 07 2019 CyberSource Global Payment Management for Magento 2 8

Figure 22 CyberSource Business Center Secure Acceptance Profiles Configuration - Create New Profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 9

212 General Settings

Figure 23 CyberSource Business Center Secure Acceptance Profiles Configuration - General Settings

After you have saved the profile you can begin configuring it The first step is General Settings Pleasemake note of the Profile ID This is a key setting needed for Magento See Section 34 and Section 39

Note Payment Tokenization is required

Oct 07 2019 CyberSource Global Payment Management for Magento 2 10

Note Decision Manager and related settings are required only if you use Decision Manager

213 Payment Settings

In this section you can specify which card types are allowed for the payment method You can alsoselect currency CVN Display CVN Required and Payer Authentication options

Note In order to enable PayPal Express Checkout payments just enable and configure it in Magentosettings not here The extension implements PayPal payments natively See Section 310

Oct 07 2019 CyberSource Global Payment Management for Magento 2 11

Figure 24 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Settings

214 Security

In the Security panel you will create an Access Key and a Secret Key needed to complete the setup ofthe Magento 2 Module See Section 34 and Section 39

Oct 07 2019 CyberSource Global Payment Management for Magento 2 12

Figure 25 CyberSource Business Center Secure Acceptance Profiles Configuration - Security Settings

If you still donrsquot have any keys generated click on lsquo+rsquo button and create a new key

Figure 26 CyberSource Business Center Secure Acceptance Profiles Configuration - Key Creation

215 Payment Form

If using Secure Acceptance Hosted Checkout (WebMobile) when a customer is either redirected tothe hosted payment page at CyberSource or if they see the modal popup window during checkoutthey will see a payment form that has been configured with the settings below These settings are notapplicable for the Secure Acceptance Checkout API (Silent Order POST) configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 13

Figure 27 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Form Set-ting

These settings have no effect on the integration with Magento and can be configured to your specificneeds

216 Notifications

On this configuration panel you must choose the Merchant POST URL tick box and input callback URLto your store

Oct 07 2019 CyberSource Global Payment Management for Magento 2 14

Figure 28 CyberSource Business Center Secure Acceptance Profiles Configuration - Notifications Set-tings

The Merchant POST URL is ltyour base urlgt + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Merchant POST URL would behttpwwwexamplecomcybersourceindexplaceOrder

When you configure a Merchant POST URL you will also see additional settings for the card digitsreturned and stored in Magento

217 Customer Response

Response pages are URLrsquos that customers get directed to when a transaction is completed or has beencancelled

Oct 07 2019 CyberSource Global Payment Management for Magento 2 15

Figure 29 CyberSource Business Center Secure Acceptance Profiles Configuration - Customer ResponseConfiguration

Your Transaction Response page URL is your base url + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexplaceOrder

Your Custom Cancel Response Page URL is your base url + cybersourceindexcancel

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexcancel

Oct 07 2019 CyberSource Global Payment Management for Magento 2 16

218 Branding

In this section you can customize look and feel of the Hosted Checkout page It doesnrsquot affect Magentointegration directly These settings are not applicable for the Secure Acceptance Checkout API (SilentOrder POST)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 17

22 Decision Manager

For the purposes of configuring Magento to work with Decision Manager the following sections out-line some brief topics that help describe how Magento and Decision Manger will work together

221 Orders

When enabled Decision Manager runs in real time with the Authorization The possible decisions areACCEPT REJECT REVIEW or ERROR Orders set to REVIEW by Decision Manager will be marked asPending Review in Magento

When you change an order in Decision Manager Case Management from REVIEW to REJECT or AC-CEPT Magento will not immediately learn of this change Magento will learn of any changes to pay-ment transaction states periodically (by cron every 2 minutes) by contacting CyberSource and query-ing for changes Section 36 describes how you configure Magento Cron settings that will trigger aMagento task that will look for Decision Manager changes and update Magento Orders accordingly

If a change in state is detected the module will update the order status in Magento from PendingReview to one of these states Processing Pending Payment or Closed

Please note that if an order is Pending Review in Decision Manager you cannot prepare an invoice inMagento until it is accepted in Decision Manager

222 Refunds

Please note the order must be either Accepted or Rejected in Decision Manager before you are ableto issue a refund Rejecting an order in Decision Manager will automatically perform an AuthorizationReversal for the order as part of the Cron process that queries CyberSource for updates in DecisionManager

223 Custom Fields

Decision Manager supports up to 100 custom fields called Merchant Defined Data Fields The Cy-berSource Module for Magento 2 will send ten of these fields but they must be configured insideDecision Manager in order to make use of them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 18

Figure 210 CyberSource Business Center Decision Manager Custom Fields Configuration

To add the additional custom fields provided by Magento 2 login to the Business Center and navigateto Decision Manager gt Shared Configuration gt Custom Fields Use the tables below to configure thefields

To add a field click the Add Custom Field button select the Order Element and input the name Followthe table below to map the correct element and name

Field Name Order ElementLogged in customer merchant_defined_data1Account creation date merchant_defined_data2Purchase History Count merchant_defined_data3Last Order Date merchant_defined_data4Member account age merchant_defined_data5Repeat customer merchant_defined_data6Coupon Code Used merchant_defined_data20Discount Amount merchant_defined_data21Gift Message merchant_defined_data22Order Source merchant_defined_data23Shipping Method Code merchant_defined_data31Shipping Method Description merchant_defined_data32

For complete Decision Manager configuration instructions please refer to the CyberSource DecisionManager User Guide referenced in Section 6 of this manual

Oct 07 2019 CyberSource Global Payment Management for Magento 2 19

23 Security Credentials

In addition to the Secure Acceptance security credentials created in Section 21 the module usesother connection methods to access CyberSource services that require their own security credentialsfor authentication

Note Configuring of SOAP Toolkit Key is mandatory for this extension proper functioning

231 Create a SOAP Toolkit Key

The CyberSource Module for Magento makes use of the SOAP Toolkit API to access several Cyber-Source services that do not include the transmission of card data

To create a SOAP Toolkit API transaction key navigate in the Enterprise Business Center to PaymentConfiguration gt Key Management

1 Click the ldquoGenerate Keyrdquo button

2 Select the ldquoTransaction processingrdquo key type and click ldquoNext Steprdquo

3 Select the ldquoSOAPrdquo as key subtype and click ldquoSubmitrdquo

4 Save the resulting key for purposes of entering in your Magento configuration

Figure 211 Create a Transaction Security Key - Selecting Key Type

Oct 07 2019 CyberSource Global Payment Management for Magento 2 20

Figure 212 Create a Transaction Security Key - Selecting Key Subtype

Figure 213 Create a Transaction Security Key - Generated SOAP Toolkit Key

Oct 07 2019 CyberSource Global Payment Management for Magento 2 21

232 Create a Report Download User

The CyberSourceModule for Magento uses a reporting API that allowsMagento to query CyberSourcefor information about transactions To activate this you must create a separate CyberSource BusinessCenter user with the role of ldquoReport Downloadrdquo

Figure 214 CyberSource Business Center Main Navigation - User Administration

Navigate to the Account Management gt User Administration section of the main navigation Thescreen will show a listing of active users Click the ldquoAdd Userrdquo button The next screen will look likethis

Oct 07 2019 CyberSource Global Payment Management for Magento 2 22

Figure 215 Add New CyberSource Business Center User Screen

Fill out the form and select lsquoReport Downloadrsquo User Role Once you complete the Add User form anemail will be sent to the address used on the form The email will contain a link and a onetime lsquotokenrsquoused to validate the email account Once the token is entered you will be asked to reset the passwordThis password is needed in Section 31 for the lsquoReport Passwordrsquo

Oct 07 2019 CyberSource Global Payment Management for Magento 2 23

24 Backend Setup

Certain CyberSource services supported by the Module require additional backend setup on yourMerchant ID Please contact your CyberSource Account Representative to enable any of the followingservices

1 Payment Tokenization Required by the Module for Credit Card processing

2 Decision Manager

3 Payer Authentication

4 PayPal Express Checkout New credentials are required for Alt Pay connection Additional setupin PayPal is documented in the PayPal guide listed in Section 6 of this document

5 eChecks

6 Online Bank Transfers

7 Tax Calculation

8 Klarna

9 Account Takeover Protection

10 Account Updater

11 Visa Checkout (enabled in the EBC)

12 Apple Pay (enabled in the EBC)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 24

3 Magento Backend Configuration Settings

Once logged into the administration section of your Magento 2 website the configuration panel isfound by navigating to the following screen

Stores gt Configuration gt Sales gt Payment Methods

Once on that screen you will see the settings for the CyberSource module Inside this panel areadditional sub panels

25

Figure 31 Main CyberSource configuration panel with sub panels

Oct 07 2019 CyberSource Global Payment Management for Magento 2 26

31 General Settings

Figure 32 General Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 27

Figure 33 General Settings (continued)

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of Secure Acceptance

payment method for credit cards This is used for both Web Mobileand Silent Order Post configurations

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 28

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 9: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

19 Tax Calculation

The tax calculation service provides real-time tax calculation at the time of checkout for orders placedworldwide with your business

The CyberSource Magento extension supports the Tax calculation service

110 Delivery Address Verification

The Delivery Address Verification service verifies typed addresses and corrects invalid citystateZIPcombinations in real-time

The CyberSourceMagento extension supports the Delivery Address Verification service while updatingshipping information if this feature is enabled in the Magento admin

111 PayPal Credit

PayPal Credit is a payment method allowing merchants to accept a PayPal transaction where thecustomer elects to finance their purchase through PayPal

112 Visa Checkout

Visa Checkout can increase sales conversion by making it easier for your customers to pay with theircard online The CyberSource extension for Magento supports the following services

bull Visa Checkout button

bull Get Visa Checkout Data

bull Authorization

bull Sale (Authorization + Capture)

bull Authorization Reversal

bull Capture

bull Credit

bull Void

113 Klarna

Klarna credit provides a seamless user experience for online consumer financing to merchants ofall sizes increasing consumer choice loyalty and grow sales

The goal of this is to implement Authorize Capture and Refund functionality for this pay-ment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 6

2 CyberSource Configuration

Before configuring Magento the CyberSource Enterprise Business Center needs to be configured

Customer payments are managed by both Magento and the CyberSource Enterprise Business Center(EBC) This section covers the mandatory settings that must be configured in the EBC as well as somegeneral use cases that will be typical in the day to day management of your Magento store

Merchants will need to contact CyberSource Customer Support for product availability and enable-ment

21 Secure Acceptance Configuration

To start profile configuration visit the CyberSource Business Center by following one of these URLrsquos

Testing URL httpsebctestcybersourcecomebc2

Production URL httpsebccybersourcecomebc2

In the left navigation panel choose Payment Configuration gt Secure Acceptance Settings

Once on that panel choose the button in the top right labeled Create New Profile

Figure 21 CyberSource Business Center Secure Acceptance Profiles Configuration - New Profile button

7

211 Create New Profile

A Magento instance can have many Secure Acceptance Profiles but you need at least one The Profilewill hold settings related to the cards you accept the currency and other settings including the ProfileID and Security Access Keys needed by Magento to communicate with CyberSource

Figure 22 below shows the profile creation screen Secure Acceptance is offered in two differentmodes

bull Hosted Checkout (formerlyWebMobile) is a hosted payment page available in iframe or redirectmethod

bull Checkout API (formerly Silent Order POST (SOP)) directly posts card data from your customersrsquobrowser to CyberSource The customer never leaves your site and your site never receives anycard data which reduces PCI DSS scope

Ensure you select either the Hosted Checkout or Checkout API Integration Method and select allrelevant checkboxes in the Added Value Services section

Note Payment Tokenization is required for using this extension Decision Manager is optional

Oct 07 2019 CyberSource Global Payment Management for Magento 2 8

Figure 22 CyberSource Business Center Secure Acceptance Profiles Configuration - Create New Profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 9

212 General Settings

Figure 23 CyberSource Business Center Secure Acceptance Profiles Configuration - General Settings

After you have saved the profile you can begin configuring it The first step is General Settings Pleasemake note of the Profile ID This is a key setting needed for Magento See Section 34 and Section 39

Note Payment Tokenization is required

Oct 07 2019 CyberSource Global Payment Management for Magento 2 10

Note Decision Manager and related settings are required only if you use Decision Manager

213 Payment Settings

In this section you can specify which card types are allowed for the payment method You can alsoselect currency CVN Display CVN Required and Payer Authentication options

Note In order to enable PayPal Express Checkout payments just enable and configure it in Magentosettings not here The extension implements PayPal payments natively See Section 310

Oct 07 2019 CyberSource Global Payment Management for Magento 2 11

Figure 24 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Settings

214 Security

In the Security panel you will create an Access Key and a Secret Key needed to complete the setup ofthe Magento 2 Module See Section 34 and Section 39

Oct 07 2019 CyberSource Global Payment Management for Magento 2 12

Figure 25 CyberSource Business Center Secure Acceptance Profiles Configuration - Security Settings

If you still donrsquot have any keys generated click on lsquo+rsquo button and create a new key

Figure 26 CyberSource Business Center Secure Acceptance Profiles Configuration - Key Creation

215 Payment Form

If using Secure Acceptance Hosted Checkout (WebMobile) when a customer is either redirected tothe hosted payment page at CyberSource or if they see the modal popup window during checkoutthey will see a payment form that has been configured with the settings below These settings are notapplicable for the Secure Acceptance Checkout API (Silent Order POST) configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 13

Figure 27 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Form Set-ting

These settings have no effect on the integration with Magento and can be configured to your specificneeds

216 Notifications

On this configuration panel you must choose the Merchant POST URL tick box and input callback URLto your store

Oct 07 2019 CyberSource Global Payment Management for Magento 2 14

Figure 28 CyberSource Business Center Secure Acceptance Profiles Configuration - Notifications Set-tings

The Merchant POST URL is ltyour base urlgt + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Merchant POST URL would behttpwwwexamplecomcybersourceindexplaceOrder

When you configure a Merchant POST URL you will also see additional settings for the card digitsreturned and stored in Magento

217 Customer Response

Response pages are URLrsquos that customers get directed to when a transaction is completed or has beencancelled

Oct 07 2019 CyberSource Global Payment Management for Magento 2 15

Figure 29 CyberSource Business Center Secure Acceptance Profiles Configuration - Customer ResponseConfiguration

Your Transaction Response page URL is your base url + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexplaceOrder

Your Custom Cancel Response Page URL is your base url + cybersourceindexcancel

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexcancel

Oct 07 2019 CyberSource Global Payment Management for Magento 2 16

218 Branding

In this section you can customize look and feel of the Hosted Checkout page It doesnrsquot affect Magentointegration directly These settings are not applicable for the Secure Acceptance Checkout API (SilentOrder POST)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 17

22 Decision Manager

For the purposes of configuring Magento to work with Decision Manager the following sections out-line some brief topics that help describe how Magento and Decision Manger will work together

221 Orders

When enabled Decision Manager runs in real time with the Authorization The possible decisions areACCEPT REJECT REVIEW or ERROR Orders set to REVIEW by Decision Manager will be marked asPending Review in Magento

When you change an order in Decision Manager Case Management from REVIEW to REJECT or AC-CEPT Magento will not immediately learn of this change Magento will learn of any changes to pay-ment transaction states periodically (by cron every 2 minutes) by contacting CyberSource and query-ing for changes Section 36 describes how you configure Magento Cron settings that will trigger aMagento task that will look for Decision Manager changes and update Magento Orders accordingly

If a change in state is detected the module will update the order status in Magento from PendingReview to one of these states Processing Pending Payment or Closed

Please note that if an order is Pending Review in Decision Manager you cannot prepare an invoice inMagento until it is accepted in Decision Manager

222 Refunds

Please note the order must be either Accepted or Rejected in Decision Manager before you are ableto issue a refund Rejecting an order in Decision Manager will automatically perform an AuthorizationReversal for the order as part of the Cron process that queries CyberSource for updates in DecisionManager

223 Custom Fields

Decision Manager supports up to 100 custom fields called Merchant Defined Data Fields The Cy-berSource Module for Magento 2 will send ten of these fields but they must be configured insideDecision Manager in order to make use of them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 18

Figure 210 CyberSource Business Center Decision Manager Custom Fields Configuration

To add the additional custom fields provided by Magento 2 login to the Business Center and navigateto Decision Manager gt Shared Configuration gt Custom Fields Use the tables below to configure thefields

To add a field click the Add Custom Field button select the Order Element and input the name Followthe table below to map the correct element and name

Field Name Order ElementLogged in customer merchant_defined_data1Account creation date merchant_defined_data2Purchase History Count merchant_defined_data3Last Order Date merchant_defined_data4Member account age merchant_defined_data5Repeat customer merchant_defined_data6Coupon Code Used merchant_defined_data20Discount Amount merchant_defined_data21Gift Message merchant_defined_data22Order Source merchant_defined_data23Shipping Method Code merchant_defined_data31Shipping Method Description merchant_defined_data32

For complete Decision Manager configuration instructions please refer to the CyberSource DecisionManager User Guide referenced in Section 6 of this manual

Oct 07 2019 CyberSource Global Payment Management for Magento 2 19

23 Security Credentials

In addition to the Secure Acceptance security credentials created in Section 21 the module usesother connection methods to access CyberSource services that require their own security credentialsfor authentication

Note Configuring of SOAP Toolkit Key is mandatory for this extension proper functioning

231 Create a SOAP Toolkit Key

The CyberSource Module for Magento makes use of the SOAP Toolkit API to access several Cyber-Source services that do not include the transmission of card data

To create a SOAP Toolkit API transaction key navigate in the Enterprise Business Center to PaymentConfiguration gt Key Management

1 Click the ldquoGenerate Keyrdquo button

2 Select the ldquoTransaction processingrdquo key type and click ldquoNext Steprdquo

3 Select the ldquoSOAPrdquo as key subtype and click ldquoSubmitrdquo

4 Save the resulting key for purposes of entering in your Magento configuration

Figure 211 Create a Transaction Security Key - Selecting Key Type

Oct 07 2019 CyberSource Global Payment Management for Magento 2 20

Figure 212 Create a Transaction Security Key - Selecting Key Subtype

Figure 213 Create a Transaction Security Key - Generated SOAP Toolkit Key

Oct 07 2019 CyberSource Global Payment Management for Magento 2 21

232 Create a Report Download User

The CyberSourceModule for Magento uses a reporting API that allowsMagento to query CyberSourcefor information about transactions To activate this you must create a separate CyberSource BusinessCenter user with the role of ldquoReport Downloadrdquo

Figure 214 CyberSource Business Center Main Navigation - User Administration

Navigate to the Account Management gt User Administration section of the main navigation Thescreen will show a listing of active users Click the ldquoAdd Userrdquo button The next screen will look likethis

Oct 07 2019 CyberSource Global Payment Management for Magento 2 22

Figure 215 Add New CyberSource Business Center User Screen

Fill out the form and select lsquoReport Downloadrsquo User Role Once you complete the Add User form anemail will be sent to the address used on the form The email will contain a link and a onetime lsquotokenrsquoused to validate the email account Once the token is entered you will be asked to reset the passwordThis password is needed in Section 31 for the lsquoReport Passwordrsquo

Oct 07 2019 CyberSource Global Payment Management for Magento 2 23

24 Backend Setup

Certain CyberSource services supported by the Module require additional backend setup on yourMerchant ID Please contact your CyberSource Account Representative to enable any of the followingservices

1 Payment Tokenization Required by the Module for Credit Card processing

2 Decision Manager

3 Payer Authentication

4 PayPal Express Checkout New credentials are required for Alt Pay connection Additional setupin PayPal is documented in the PayPal guide listed in Section 6 of this document

5 eChecks

6 Online Bank Transfers

7 Tax Calculation

8 Klarna

9 Account Takeover Protection

10 Account Updater

11 Visa Checkout (enabled in the EBC)

12 Apple Pay (enabled in the EBC)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 24

3 Magento Backend Configuration Settings

Once logged into the administration section of your Magento 2 website the configuration panel isfound by navigating to the following screen

Stores gt Configuration gt Sales gt Payment Methods

Once on that screen you will see the settings for the CyberSource module Inside this panel areadditional sub panels

25

Figure 31 Main CyberSource configuration panel with sub panels

Oct 07 2019 CyberSource Global Payment Management for Magento 2 26

31 General Settings

Figure 32 General Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 27

Figure 33 General Settings (continued)

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of Secure Acceptance

payment method for credit cards This is used for both Web Mobileand Silent Order Post configurations

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 28

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 10: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

2 CyberSource Configuration

Before configuring Magento the CyberSource Enterprise Business Center needs to be configured

Customer payments are managed by both Magento and the CyberSource Enterprise Business Center(EBC) This section covers the mandatory settings that must be configured in the EBC as well as somegeneral use cases that will be typical in the day to day management of your Magento store

Merchants will need to contact CyberSource Customer Support for product availability and enable-ment

21 Secure Acceptance Configuration

To start profile configuration visit the CyberSource Business Center by following one of these URLrsquos

Testing URL httpsebctestcybersourcecomebc2

Production URL httpsebccybersourcecomebc2

In the left navigation panel choose Payment Configuration gt Secure Acceptance Settings

Once on that panel choose the button in the top right labeled Create New Profile

Figure 21 CyberSource Business Center Secure Acceptance Profiles Configuration - New Profile button

7

211 Create New Profile

A Magento instance can have many Secure Acceptance Profiles but you need at least one The Profilewill hold settings related to the cards you accept the currency and other settings including the ProfileID and Security Access Keys needed by Magento to communicate with CyberSource

Figure 22 below shows the profile creation screen Secure Acceptance is offered in two differentmodes

bull Hosted Checkout (formerlyWebMobile) is a hosted payment page available in iframe or redirectmethod

bull Checkout API (formerly Silent Order POST (SOP)) directly posts card data from your customersrsquobrowser to CyberSource The customer never leaves your site and your site never receives anycard data which reduces PCI DSS scope

Ensure you select either the Hosted Checkout or Checkout API Integration Method and select allrelevant checkboxes in the Added Value Services section

Note Payment Tokenization is required for using this extension Decision Manager is optional

Oct 07 2019 CyberSource Global Payment Management for Magento 2 8

Figure 22 CyberSource Business Center Secure Acceptance Profiles Configuration - Create New Profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 9

212 General Settings

Figure 23 CyberSource Business Center Secure Acceptance Profiles Configuration - General Settings

After you have saved the profile you can begin configuring it The first step is General Settings Pleasemake note of the Profile ID This is a key setting needed for Magento See Section 34 and Section 39

Note Payment Tokenization is required

Oct 07 2019 CyberSource Global Payment Management for Magento 2 10

Note Decision Manager and related settings are required only if you use Decision Manager

213 Payment Settings

In this section you can specify which card types are allowed for the payment method You can alsoselect currency CVN Display CVN Required and Payer Authentication options

Note In order to enable PayPal Express Checkout payments just enable and configure it in Magentosettings not here The extension implements PayPal payments natively See Section 310

Oct 07 2019 CyberSource Global Payment Management for Magento 2 11

Figure 24 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Settings

214 Security

In the Security panel you will create an Access Key and a Secret Key needed to complete the setup ofthe Magento 2 Module See Section 34 and Section 39

Oct 07 2019 CyberSource Global Payment Management for Magento 2 12

Figure 25 CyberSource Business Center Secure Acceptance Profiles Configuration - Security Settings

If you still donrsquot have any keys generated click on lsquo+rsquo button and create a new key

Figure 26 CyberSource Business Center Secure Acceptance Profiles Configuration - Key Creation

215 Payment Form

If using Secure Acceptance Hosted Checkout (WebMobile) when a customer is either redirected tothe hosted payment page at CyberSource or if they see the modal popup window during checkoutthey will see a payment form that has been configured with the settings below These settings are notapplicable for the Secure Acceptance Checkout API (Silent Order POST) configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 13

Figure 27 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Form Set-ting

These settings have no effect on the integration with Magento and can be configured to your specificneeds

216 Notifications

On this configuration panel you must choose the Merchant POST URL tick box and input callback URLto your store

Oct 07 2019 CyberSource Global Payment Management for Magento 2 14

Figure 28 CyberSource Business Center Secure Acceptance Profiles Configuration - Notifications Set-tings

The Merchant POST URL is ltyour base urlgt + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Merchant POST URL would behttpwwwexamplecomcybersourceindexplaceOrder

When you configure a Merchant POST URL you will also see additional settings for the card digitsreturned and stored in Magento

217 Customer Response

Response pages are URLrsquos that customers get directed to when a transaction is completed or has beencancelled

Oct 07 2019 CyberSource Global Payment Management for Magento 2 15

Figure 29 CyberSource Business Center Secure Acceptance Profiles Configuration - Customer ResponseConfiguration

Your Transaction Response page URL is your base url + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexplaceOrder

Your Custom Cancel Response Page URL is your base url + cybersourceindexcancel

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexcancel

Oct 07 2019 CyberSource Global Payment Management for Magento 2 16

218 Branding

In this section you can customize look and feel of the Hosted Checkout page It doesnrsquot affect Magentointegration directly These settings are not applicable for the Secure Acceptance Checkout API (SilentOrder POST)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 17

22 Decision Manager

For the purposes of configuring Magento to work with Decision Manager the following sections out-line some brief topics that help describe how Magento and Decision Manger will work together

221 Orders

When enabled Decision Manager runs in real time with the Authorization The possible decisions areACCEPT REJECT REVIEW or ERROR Orders set to REVIEW by Decision Manager will be marked asPending Review in Magento

When you change an order in Decision Manager Case Management from REVIEW to REJECT or AC-CEPT Magento will not immediately learn of this change Magento will learn of any changes to pay-ment transaction states periodically (by cron every 2 minutes) by contacting CyberSource and query-ing for changes Section 36 describes how you configure Magento Cron settings that will trigger aMagento task that will look for Decision Manager changes and update Magento Orders accordingly

If a change in state is detected the module will update the order status in Magento from PendingReview to one of these states Processing Pending Payment or Closed

Please note that if an order is Pending Review in Decision Manager you cannot prepare an invoice inMagento until it is accepted in Decision Manager

222 Refunds

Please note the order must be either Accepted or Rejected in Decision Manager before you are ableto issue a refund Rejecting an order in Decision Manager will automatically perform an AuthorizationReversal for the order as part of the Cron process that queries CyberSource for updates in DecisionManager

223 Custom Fields

Decision Manager supports up to 100 custom fields called Merchant Defined Data Fields The Cy-berSource Module for Magento 2 will send ten of these fields but they must be configured insideDecision Manager in order to make use of them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 18

Figure 210 CyberSource Business Center Decision Manager Custom Fields Configuration

To add the additional custom fields provided by Magento 2 login to the Business Center and navigateto Decision Manager gt Shared Configuration gt Custom Fields Use the tables below to configure thefields

To add a field click the Add Custom Field button select the Order Element and input the name Followthe table below to map the correct element and name

Field Name Order ElementLogged in customer merchant_defined_data1Account creation date merchant_defined_data2Purchase History Count merchant_defined_data3Last Order Date merchant_defined_data4Member account age merchant_defined_data5Repeat customer merchant_defined_data6Coupon Code Used merchant_defined_data20Discount Amount merchant_defined_data21Gift Message merchant_defined_data22Order Source merchant_defined_data23Shipping Method Code merchant_defined_data31Shipping Method Description merchant_defined_data32

For complete Decision Manager configuration instructions please refer to the CyberSource DecisionManager User Guide referenced in Section 6 of this manual

Oct 07 2019 CyberSource Global Payment Management for Magento 2 19

23 Security Credentials

In addition to the Secure Acceptance security credentials created in Section 21 the module usesother connection methods to access CyberSource services that require their own security credentialsfor authentication

Note Configuring of SOAP Toolkit Key is mandatory for this extension proper functioning

231 Create a SOAP Toolkit Key

The CyberSource Module for Magento makes use of the SOAP Toolkit API to access several Cyber-Source services that do not include the transmission of card data

To create a SOAP Toolkit API transaction key navigate in the Enterprise Business Center to PaymentConfiguration gt Key Management

1 Click the ldquoGenerate Keyrdquo button

2 Select the ldquoTransaction processingrdquo key type and click ldquoNext Steprdquo

3 Select the ldquoSOAPrdquo as key subtype and click ldquoSubmitrdquo

4 Save the resulting key for purposes of entering in your Magento configuration

Figure 211 Create a Transaction Security Key - Selecting Key Type

Oct 07 2019 CyberSource Global Payment Management for Magento 2 20

Figure 212 Create a Transaction Security Key - Selecting Key Subtype

Figure 213 Create a Transaction Security Key - Generated SOAP Toolkit Key

Oct 07 2019 CyberSource Global Payment Management for Magento 2 21

232 Create a Report Download User

The CyberSourceModule for Magento uses a reporting API that allowsMagento to query CyberSourcefor information about transactions To activate this you must create a separate CyberSource BusinessCenter user with the role of ldquoReport Downloadrdquo

Figure 214 CyberSource Business Center Main Navigation - User Administration

Navigate to the Account Management gt User Administration section of the main navigation Thescreen will show a listing of active users Click the ldquoAdd Userrdquo button The next screen will look likethis

Oct 07 2019 CyberSource Global Payment Management for Magento 2 22

Figure 215 Add New CyberSource Business Center User Screen

Fill out the form and select lsquoReport Downloadrsquo User Role Once you complete the Add User form anemail will be sent to the address used on the form The email will contain a link and a onetime lsquotokenrsquoused to validate the email account Once the token is entered you will be asked to reset the passwordThis password is needed in Section 31 for the lsquoReport Passwordrsquo

Oct 07 2019 CyberSource Global Payment Management for Magento 2 23

24 Backend Setup

Certain CyberSource services supported by the Module require additional backend setup on yourMerchant ID Please contact your CyberSource Account Representative to enable any of the followingservices

1 Payment Tokenization Required by the Module for Credit Card processing

2 Decision Manager

3 Payer Authentication

4 PayPal Express Checkout New credentials are required for Alt Pay connection Additional setupin PayPal is documented in the PayPal guide listed in Section 6 of this document

5 eChecks

6 Online Bank Transfers

7 Tax Calculation

8 Klarna

9 Account Takeover Protection

10 Account Updater

11 Visa Checkout (enabled in the EBC)

12 Apple Pay (enabled in the EBC)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 24

3 Magento Backend Configuration Settings

Once logged into the administration section of your Magento 2 website the configuration panel isfound by navigating to the following screen

Stores gt Configuration gt Sales gt Payment Methods

Once on that screen you will see the settings for the CyberSource module Inside this panel areadditional sub panels

25

Figure 31 Main CyberSource configuration panel with sub panels

Oct 07 2019 CyberSource Global Payment Management for Magento 2 26

31 General Settings

Figure 32 General Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 27

Figure 33 General Settings (continued)

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of Secure Acceptance

payment method for credit cards This is used for both Web Mobileand Silent Order Post configurations

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 28

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 11: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

211 Create New Profile

A Magento instance can have many Secure Acceptance Profiles but you need at least one The Profilewill hold settings related to the cards you accept the currency and other settings including the ProfileID and Security Access Keys needed by Magento to communicate with CyberSource

Figure 22 below shows the profile creation screen Secure Acceptance is offered in two differentmodes

bull Hosted Checkout (formerlyWebMobile) is a hosted payment page available in iframe or redirectmethod

bull Checkout API (formerly Silent Order POST (SOP)) directly posts card data from your customersrsquobrowser to CyberSource The customer never leaves your site and your site never receives anycard data which reduces PCI DSS scope

Ensure you select either the Hosted Checkout or Checkout API Integration Method and select allrelevant checkboxes in the Added Value Services section

Note Payment Tokenization is required for using this extension Decision Manager is optional

Oct 07 2019 CyberSource Global Payment Management for Magento 2 8

Figure 22 CyberSource Business Center Secure Acceptance Profiles Configuration - Create New Profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 9

212 General Settings

Figure 23 CyberSource Business Center Secure Acceptance Profiles Configuration - General Settings

After you have saved the profile you can begin configuring it The first step is General Settings Pleasemake note of the Profile ID This is a key setting needed for Magento See Section 34 and Section 39

Note Payment Tokenization is required

Oct 07 2019 CyberSource Global Payment Management for Magento 2 10

Note Decision Manager and related settings are required only if you use Decision Manager

213 Payment Settings

In this section you can specify which card types are allowed for the payment method You can alsoselect currency CVN Display CVN Required and Payer Authentication options

Note In order to enable PayPal Express Checkout payments just enable and configure it in Magentosettings not here The extension implements PayPal payments natively See Section 310

Oct 07 2019 CyberSource Global Payment Management for Magento 2 11

Figure 24 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Settings

214 Security

In the Security panel you will create an Access Key and a Secret Key needed to complete the setup ofthe Magento 2 Module See Section 34 and Section 39

Oct 07 2019 CyberSource Global Payment Management for Magento 2 12

Figure 25 CyberSource Business Center Secure Acceptance Profiles Configuration - Security Settings

If you still donrsquot have any keys generated click on lsquo+rsquo button and create a new key

Figure 26 CyberSource Business Center Secure Acceptance Profiles Configuration - Key Creation

215 Payment Form

If using Secure Acceptance Hosted Checkout (WebMobile) when a customer is either redirected tothe hosted payment page at CyberSource or if they see the modal popup window during checkoutthey will see a payment form that has been configured with the settings below These settings are notapplicable for the Secure Acceptance Checkout API (Silent Order POST) configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 13

Figure 27 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Form Set-ting

These settings have no effect on the integration with Magento and can be configured to your specificneeds

216 Notifications

On this configuration panel you must choose the Merchant POST URL tick box and input callback URLto your store

Oct 07 2019 CyberSource Global Payment Management for Magento 2 14

Figure 28 CyberSource Business Center Secure Acceptance Profiles Configuration - Notifications Set-tings

The Merchant POST URL is ltyour base urlgt + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Merchant POST URL would behttpwwwexamplecomcybersourceindexplaceOrder

When you configure a Merchant POST URL you will also see additional settings for the card digitsreturned and stored in Magento

217 Customer Response

Response pages are URLrsquos that customers get directed to when a transaction is completed or has beencancelled

Oct 07 2019 CyberSource Global Payment Management for Magento 2 15

Figure 29 CyberSource Business Center Secure Acceptance Profiles Configuration - Customer ResponseConfiguration

Your Transaction Response page URL is your base url + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexplaceOrder

Your Custom Cancel Response Page URL is your base url + cybersourceindexcancel

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexcancel

Oct 07 2019 CyberSource Global Payment Management for Magento 2 16

218 Branding

In this section you can customize look and feel of the Hosted Checkout page It doesnrsquot affect Magentointegration directly These settings are not applicable for the Secure Acceptance Checkout API (SilentOrder POST)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 17

22 Decision Manager

For the purposes of configuring Magento to work with Decision Manager the following sections out-line some brief topics that help describe how Magento and Decision Manger will work together

221 Orders

When enabled Decision Manager runs in real time with the Authorization The possible decisions areACCEPT REJECT REVIEW or ERROR Orders set to REVIEW by Decision Manager will be marked asPending Review in Magento

When you change an order in Decision Manager Case Management from REVIEW to REJECT or AC-CEPT Magento will not immediately learn of this change Magento will learn of any changes to pay-ment transaction states periodically (by cron every 2 minutes) by contacting CyberSource and query-ing for changes Section 36 describes how you configure Magento Cron settings that will trigger aMagento task that will look for Decision Manager changes and update Magento Orders accordingly

If a change in state is detected the module will update the order status in Magento from PendingReview to one of these states Processing Pending Payment or Closed

Please note that if an order is Pending Review in Decision Manager you cannot prepare an invoice inMagento until it is accepted in Decision Manager

222 Refunds

Please note the order must be either Accepted or Rejected in Decision Manager before you are ableto issue a refund Rejecting an order in Decision Manager will automatically perform an AuthorizationReversal for the order as part of the Cron process that queries CyberSource for updates in DecisionManager

223 Custom Fields

Decision Manager supports up to 100 custom fields called Merchant Defined Data Fields The Cy-berSource Module for Magento 2 will send ten of these fields but they must be configured insideDecision Manager in order to make use of them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 18

Figure 210 CyberSource Business Center Decision Manager Custom Fields Configuration

To add the additional custom fields provided by Magento 2 login to the Business Center and navigateto Decision Manager gt Shared Configuration gt Custom Fields Use the tables below to configure thefields

To add a field click the Add Custom Field button select the Order Element and input the name Followthe table below to map the correct element and name

Field Name Order ElementLogged in customer merchant_defined_data1Account creation date merchant_defined_data2Purchase History Count merchant_defined_data3Last Order Date merchant_defined_data4Member account age merchant_defined_data5Repeat customer merchant_defined_data6Coupon Code Used merchant_defined_data20Discount Amount merchant_defined_data21Gift Message merchant_defined_data22Order Source merchant_defined_data23Shipping Method Code merchant_defined_data31Shipping Method Description merchant_defined_data32

For complete Decision Manager configuration instructions please refer to the CyberSource DecisionManager User Guide referenced in Section 6 of this manual

Oct 07 2019 CyberSource Global Payment Management for Magento 2 19

23 Security Credentials

In addition to the Secure Acceptance security credentials created in Section 21 the module usesother connection methods to access CyberSource services that require their own security credentialsfor authentication

Note Configuring of SOAP Toolkit Key is mandatory for this extension proper functioning

231 Create a SOAP Toolkit Key

The CyberSource Module for Magento makes use of the SOAP Toolkit API to access several Cyber-Source services that do not include the transmission of card data

To create a SOAP Toolkit API transaction key navigate in the Enterprise Business Center to PaymentConfiguration gt Key Management

1 Click the ldquoGenerate Keyrdquo button

2 Select the ldquoTransaction processingrdquo key type and click ldquoNext Steprdquo

3 Select the ldquoSOAPrdquo as key subtype and click ldquoSubmitrdquo

4 Save the resulting key for purposes of entering in your Magento configuration

Figure 211 Create a Transaction Security Key - Selecting Key Type

Oct 07 2019 CyberSource Global Payment Management for Magento 2 20

Figure 212 Create a Transaction Security Key - Selecting Key Subtype

Figure 213 Create a Transaction Security Key - Generated SOAP Toolkit Key

Oct 07 2019 CyberSource Global Payment Management for Magento 2 21

232 Create a Report Download User

The CyberSourceModule for Magento uses a reporting API that allowsMagento to query CyberSourcefor information about transactions To activate this you must create a separate CyberSource BusinessCenter user with the role of ldquoReport Downloadrdquo

Figure 214 CyberSource Business Center Main Navigation - User Administration

Navigate to the Account Management gt User Administration section of the main navigation Thescreen will show a listing of active users Click the ldquoAdd Userrdquo button The next screen will look likethis

Oct 07 2019 CyberSource Global Payment Management for Magento 2 22

Figure 215 Add New CyberSource Business Center User Screen

Fill out the form and select lsquoReport Downloadrsquo User Role Once you complete the Add User form anemail will be sent to the address used on the form The email will contain a link and a onetime lsquotokenrsquoused to validate the email account Once the token is entered you will be asked to reset the passwordThis password is needed in Section 31 for the lsquoReport Passwordrsquo

Oct 07 2019 CyberSource Global Payment Management for Magento 2 23

24 Backend Setup

Certain CyberSource services supported by the Module require additional backend setup on yourMerchant ID Please contact your CyberSource Account Representative to enable any of the followingservices

1 Payment Tokenization Required by the Module for Credit Card processing

2 Decision Manager

3 Payer Authentication

4 PayPal Express Checkout New credentials are required for Alt Pay connection Additional setupin PayPal is documented in the PayPal guide listed in Section 6 of this document

5 eChecks

6 Online Bank Transfers

7 Tax Calculation

8 Klarna

9 Account Takeover Protection

10 Account Updater

11 Visa Checkout (enabled in the EBC)

12 Apple Pay (enabled in the EBC)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 24

3 Magento Backend Configuration Settings

Once logged into the administration section of your Magento 2 website the configuration panel isfound by navigating to the following screen

Stores gt Configuration gt Sales gt Payment Methods

Once on that screen you will see the settings for the CyberSource module Inside this panel areadditional sub panels

25

Figure 31 Main CyberSource configuration panel with sub panels

Oct 07 2019 CyberSource Global Payment Management for Magento 2 26

31 General Settings

Figure 32 General Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 27

Figure 33 General Settings (continued)

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of Secure Acceptance

payment method for credit cards This is used for both Web Mobileand Silent Order Post configurations

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 28

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 12: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Figure 22 CyberSource Business Center Secure Acceptance Profiles Configuration - Create New Profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 9

212 General Settings

Figure 23 CyberSource Business Center Secure Acceptance Profiles Configuration - General Settings

After you have saved the profile you can begin configuring it The first step is General Settings Pleasemake note of the Profile ID This is a key setting needed for Magento See Section 34 and Section 39

Note Payment Tokenization is required

Oct 07 2019 CyberSource Global Payment Management for Magento 2 10

Note Decision Manager and related settings are required only if you use Decision Manager

213 Payment Settings

In this section you can specify which card types are allowed for the payment method You can alsoselect currency CVN Display CVN Required and Payer Authentication options

Note In order to enable PayPal Express Checkout payments just enable and configure it in Magentosettings not here The extension implements PayPal payments natively See Section 310

Oct 07 2019 CyberSource Global Payment Management for Magento 2 11

Figure 24 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Settings

214 Security

In the Security panel you will create an Access Key and a Secret Key needed to complete the setup ofthe Magento 2 Module See Section 34 and Section 39

Oct 07 2019 CyberSource Global Payment Management for Magento 2 12

Figure 25 CyberSource Business Center Secure Acceptance Profiles Configuration - Security Settings

If you still donrsquot have any keys generated click on lsquo+rsquo button and create a new key

Figure 26 CyberSource Business Center Secure Acceptance Profiles Configuration - Key Creation

215 Payment Form

If using Secure Acceptance Hosted Checkout (WebMobile) when a customer is either redirected tothe hosted payment page at CyberSource or if they see the modal popup window during checkoutthey will see a payment form that has been configured with the settings below These settings are notapplicable for the Secure Acceptance Checkout API (Silent Order POST) configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 13

Figure 27 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Form Set-ting

These settings have no effect on the integration with Magento and can be configured to your specificneeds

216 Notifications

On this configuration panel you must choose the Merchant POST URL tick box and input callback URLto your store

Oct 07 2019 CyberSource Global Payment Management for Magento 2 14

Figure 28 CyberSource Business Center Secure Acceptance Profiles Configuration - Notifications Set-tings

The Merchant POST URL is ltyour base urlgt + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Merchant POST URL would behttpwwwexamplecomcybersourceindexplaceOrder

When you configure a Merchant POST URL you will also see additional settings for the card digitsreturned and stored in Magento

217 Customer Response

Response pages are URLrsquos that customers get directed to when a transaction is completed or has beencancelled

Oct 07 2019 CyberSource Global Payment Management for Magento 2 15

Figure 29 CyberSource Business Center Secure Acceptance Profiles Configuration - Customer ResponseConfiguration

Your Transaction Response page URL is your base url + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexplaceOrder

Your Custom Cancel Response Page URL is your base url + cybersourceindexcancel

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexcancel

Oct 07 2019 CyberSource Global Payment Management for Magento 2 16

218 Branding

In this section you can customize look and feel of the Hosted Checkout page It doesnrsquot affect Magentointegration directly These settings are not applicable for the Secure Acceptance Checkout API (SilentOrder POST)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 17

22 Decision Manager

For the purposes of configuring Magento to work with Decision Manager the following sections out-line some brief topics that help describe how Magento and Decision Manger will work together

221 Orders

When enabled Decision Manager runs in real time with the Authorization The possible decisions areACCEPT REJECT REVIEW or ERROR Orders set to REVIEW by Decision Manager will be marked asPending Review in Magento

When you change an order in Decision Manager Case Management from REVIEW to REJECT or AC-CEPT Magento will not immediately learn of this change Magento will learn of any changes to pay-ment transaction states periodically (by cron every 2 minutes) by contacting CyberSource and query-ing for changes Section 36 describes how you configure Magento Cron settings that will trigger aMagento task that will look for Decision Manager changes and update Magento Orders accordingly

If a change in state is detected the module will update the order status in Magento from PendingReview to one of these states Processing Pending Payment or Closed

Please note that if an order is Pending Review in Decision Manager you cannot prepare an invoice inMagento until it is accepted in Decision Manager

222 Refunds

Please note the order must be either Accepted or Rejected in Decision Manager before you are ableto issue a refund Rejecting an order in Decision Manager will automatically perform an AuthorizationReversal for the order as part of the Cron process that queries CyberSource for updates in DecisionManager

223 Custom Fields

Decision Manager supports up to 100 custom fields called Merchant Defined Data Fields The Cy-berSource Module for Magento 2 will send ten of these fields but they must be configured insideDecision Manager in order to make use of them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 18

Figure 210 CyberSource Business Center Decision Manager Custom Fields Configuration

To add the additional custom fields provided by Magento 2 login to the Business Center and navigateto Decision Manager gt Shared Configuration gt Custom Fields Use the tables below to configure thefields

To add a field click the Add Custom Field button select the Order Element and input the name Followthe table below to map the correct element and name

Field Name Order ElementLogged in customer merchant_defined_data1Account creation date merchant_defined_data2Purchase History Count merchant_defined_data3Last Order Date merchant_defined_data4Member account age merchant_defined_data5Repeat customer merchant_defined_data6Coupon Code Used merchant_defined_data20Discount Amount merchant_defined_data21Gift Message merchant_defined_data22Order Source merchant_defined_data23Shipping Method Code merchant_defined_data31Shipping Method Description merchant_defined_data32

For complete Decision Manager configuration instructions please refer to the CyberSource DecisionManager User Guide referenced in Section 6 of this manual

Oct 07 2019 CyberSource Global Payment Management for Magento 2 19

23 Security Credentials

In addition to the Secure Acceptance security credentials created in Section 21 the module usesother connection methods to access CyberSource services that require their own security credentialsfor authentication

Note Configuring of SOAP Toolkit Key is mandatory for this extension proper functioning

231 Create a SOAP Toolkit Key

The CyberSource Module for Magento makes use of the SOAP Toolkit API to access several Cyber-Source services that do not include the transmission of card data

To create a SOAP Toolkit API transaction key navigate in the Enterprise Business Center to PaymentConfiguration gt Key Management

1 Click the ldquoGenerate Keyrdquo button

2 Select the ldquoTransaction processingrdquo key type and click ldquoNext Steprdquo

3 Select the ldquoSOAPrdquo as key subtype and click ldquoSubmitrdquo

4 Save the resulting key for purposes of entering in your Magento configuration

Figure 211 Create a Transaction Security Key - Selecting Key Type

Oct 07 2019 CyberSource Global Payment Management for Magento 2 20

Figure 212 Create a Transaction Security Key - Selecting Key Subtype

Figure 213 Create a Transaction Security Key - Generated SOAP Toolkit Key

Oct 07 2019 CyberSource Global Payment Management for Magento 2 21

232 Create a Report Download User

The CyberSourceModule for Magento uses a reporting API that allowsMagento to query CyberSourcefor information about transactions To activate this you must create a separate CyberSource BusinessCenter user with the role of ldquoReport Downloadrdquo

Figure 214 CyberSource Business Center Main Navigation - User Administration

Navigate to the Account Management gt User Administration section of the main navigation Thescreen will show a listing of active users Click the ldquoAdd Userrdquo button The next screen will look likethis

Oct 07 2019 CyberSource Global Payment Management for Magento 2 22

Figure 215 Add New CyberSource Business Center User Screen

Fill out the form and select lsquoReport Downloadrsquo User Role Once you complete the Add User form anemail will be sent to the address used on the form The email will contain a link and a onetime lsquotokenrsquoused to validate the email account Once the token is entered you will be asked to reset the passwordThis password is needed in Section 31 for the lsquoReport Passwordrsquo

Oct 07 2019 CyberSource Global Payment Management for Magento 2 23

24 Backend Setup

Certain CyberSource services supported by the Module require additional backend setup on yourMerchant ID Please contact your CyberSource Account Representative to enable any of the followingservices

1 Payment Tokenization Required by the Module for Credit Card processing

2 Decision Manager

3 Payer Authentication

4 PayPal Express Checkout New credentials are required for Alt Pay connection Additional setupin PayPal is documented in the PayPal guide listed in Section 6 of this document

5 eChecks

6 Online Bank Transfers

7 Tax Calculation

8 Klarna

9 Account Takeover Protection

10 Account Updater

11 Visa Checkout (enabled in the EBC)

12 Apple Pay (enabled in the EBC)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 24

3 Magento Backend Configuration Settings

Once logged into the administration section of your Magento 2 website the configuration panel isfound by navigating to the following screen

Stores gt Configuration gt Sales gt Payment Methods

Once on that screen you will see the settings for the CyberSource module Inside this panel areadditional sub panels

25

Figure 31 Main CyberSource configuration panel with sub panels

Oct 07 2019 CyberSource Global Payment Management for Magento 2 26

31 General Settings

Figure 32 General Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 27

Figure 33 General Settings (continued)

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of Secure Acceptance

payment method for credit cards This is used for both Web Mobileand Silent Order Post configurations

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 28

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 13: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

212 General Settings

Figure 23 CyberSource Business Center Secure Acceptance Profiles Configuration - General Settings

After you have saved the profile you can begin configuring it The first step is General Settings Pleasemake note of the Profile ID This is a key setting needed for Magento See Section 34 and Section 39

Note Payment Tokenization is required

Oct 07 2019 CyberSource Global Payment Management for Magento 2 10

Note Decision Manager and related settings are required only if you use Decision Manager

213 Payment Settings

In this section you can specify which card types are allowed for the payment method You can alsoselect currency CVN Display CVN Required and Payer Authentication options

Note In order to enable PayPal Express Checkout payments just enable and configure it in Magentosettings not here The extension implements PayPal payments natively See Section 310

Oct 07 2019 CyberSource Global Payment Management for Magento 2 11

Figure 24 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Settings

214 Security

In the Security panel you will create an Access Key and a Secret Key needed to complete the setup ofthe Magento 2 Module See Section 34 and Section 39

Oct 07 2019 CyberSource Global Payment Management for Magento 2 12

Figure 25 CyberSource Business Center Secure Acceptance Profiles Configuration - Security Settings

If you still donrsquot have any keys generated click on lsquo+rsquo button and create a new key

Figure 26 CyberSource Business Center Secure Acceptance Profiles Configuration - Key Creation

215 Payment Form

If using Secure Acceptance Hosted Checkout (WebMobile) when a customer is either redirected tothe hosted payment page at CyberSource or if they see the modal popup window during checkoutthey will see a payment form that has been configured with the settings below These settings are notapplicable for the Secure Acceptance Checkout API (Silent Order POST) configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 13

Figure 27 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Form Set-ting

These settings have no effect on the integration with Magento and can be configured to your specificneeds

216 Notifications

On this configuration panel you must choose the Merchant POST URL tick box and input callback URLto your store

Oct 07 2019 CyberSource Global Payment Management for Magento 2 14

Figure 28 CyberSource Business Center Secure Acceptance Profiles Configuration - Notifications Set-tings

The Merchant POST URL is ltyour base urlgt + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Merchant POST URL would behttpwwwexamplecomcybersourceindexplaceOrder

When you configure a Merchant POST URL you will also see additional settings for the card digitsreturned and stored in Magento

217 Customer Response

Response pages are URLrsquos that customers get directed to when a transaction is completed or has beencancelled

Oct 07 2019 CyberSource Global Payment Management for Magento 2 15

Figure 29 CyberSource Business Center Secure Acceptance Profiles Configuration - Customer ResponseConfiguration

Your Transaction Response page URL is your base url + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexplaceOrder

Your Custom Cancel Response Page URL is your base url + cybersourceindexcancel

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexcancel

Oct 07 2019 CyberSource Global Payment Management for Magento 2 16

218 Branding

In this section you can customize look and feel of the Hosted Checkout page It doesnrsquot affect Magentointegration directly These settings are not applicable for the Secure Acceptance Checkout API (SilentOrder POST)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 17

22 Decision Manager

For the purposes of configuring Magento to work with Decision Manager the following sections out-line some brief topics that help describe how Magento and Decision Manger will work together

221 Orders

When enabled Decision Manager runs in real time with the Authorization The possible decisions areACCEPT REJECT REVIEW or ERROR Orders set to REVIEW by Decision Manager will be marked asPending Review in Magento

When you change an order in Decision Manager Case Management from REVIEW to REJECT or AC-CEPT Magento will not immediately learn of this change Magento will learn of any changes to pay-ment transaction states periodically (by cron every 2 minutes) by contacting CyberSource and query-ing for changes Section 36 describes how you configure Magento Cron settings that will trigger aMagento task that will look for Decision Manager changes and update Magento Orders accordingly

If a change in state is detected the module will update the order status in Magento from PendingReview to one of these states Processing Pending Payment or Closed

Please note that if an order is Pending Review in Decision Manager you cannot prepare an invoice inMagento until it is accepted in Decision Manager

222 Refunds

Please note the order must be either Accepted or Rejected in Decision Manager before you are ableto issue a refund Rejecting an order in Decision Manager will automatically perform an AuthorizationReversal for the order as part of the Cron process that queries CyberSource for updates in DecisionManager

223 Custom Fields

Decision Manager supports up to 100 custom fields called Merchant Defined Data Fields The Cy-berSource Module for Magento 2 will send ten of these fields but they must be configured insideDecision Manager in order to make use of them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 18

Figure 210 CyberSource Business Center Decision Manager Custom Fields Configuration

To add the additional custom fields provided by Magento 2 login to the Business Center and navigateto Decision Manager gt Shared Configuration gt Custom Fields Use the tables below to configure thefields

To add a field click the Add Custom Field button select the Order Element and input the name Followthe table below to map the correct element and name

Field Name Order ElementLogged in customer merchant_defined_data1Account creation date merchant_defined_data2Purchase History Count merchant_defined_data3Last Order Date merchant_defined_data4Member account age merchant_defined_data5Repeat customer merchant_defined_data6Coupon Code Used merchant_defined_data20Discount Amount merchant_defined_data21Gift Message merchant_defined_data22Order Source merchant_defined_data23Shipping Method Code merchant_defined_data31Shipping Method Description merchant_defined_data32

For complete Decision Manager configuration instructions please refer to the CyberSource DecisionManager User Guide referenced in Section 6 of this manual

Oct 07 2019 CyberSource Global Payment Management for Magento 2 19

23 Security Credentials

In addition to the Secure Acceptance security credentials created in Section 21 the module usesother connection methods to access CyberSource services that require their own security credentialsfor authentication

Note Configuring of SOAP Toolkit Key is mandatory for this extension proper functioning

231 Create a SOAP Toolkit Key

The CyberSource Module for Magento makes use of the SOAP Toolkit API to access several Cyber-Source services that do not include the transmission of card data

To create a SOAP Toolkit API transaction key navigate in the Enterprise Business Center to PaymentConfiguration gt Key Management

1 Click the ldquoGenerate Keyrdquo button

2 Select the ldquoTransaction processingrdquo key type and click ldquoNext Steprdquo

3 Select the ldquoSOAPrdquo as key subtype and click ldquoSubmitrdquo

4 Save the resulting key for purposes of entering in your Magento configuration

Figure 211 Create a Transaction Security Key - Selecting Key Type

Oct 07 2019 CyberSource Global Payment Management for Magento 2 20

Figure 212 Create a Transaction Security Key - Selecting Key Subtype

Figure 213 Create a Transaction Security Key - Generated SOAP Toolkit Key

Oct 07 2019 CyberSource Global Payment Management for Magento 2 21

232 Create a Report Download User

The CyberSourceModule for Magento uses a reporting API that allowsMagento to query CyberSourcefor information about transactions To activate this you must create a separate CyberSource BusinessCenter user with the role of ldquoReport Downloadrdquo

Figure 214 CyberSource Business Center Main Navigation - User Administration

Navigate to the Account Management gt User Administration section of the main navigation Thescreen will show a listing of active users Click the ldquoAdd Userrdquo button The next screen will look likethis

Oct 07 2019 CyberSource Global Payment Management for Magento 2 22

Figure 215 Add New CyberSource Business Center User Screen

Fill out the form and select lsquoReport Downloadrsquo User Role Once you complete the Add User form anemail will be sent to the address used on the form The email will contain a link and a onetime lsquotokenrsquoused to validate the email account Once the token is entered you will be asked to reset the passwordThis password is needed in Section 31 for the lsquoReport Passwordrsquo

Oct 07 2019 CyberSource Global Payment Management for Magento 2 23

24 Backend Setup

Certain CyberSource services supported by the Module require additional backend setup on yourMerchant ID Please contact your CyberSource Account Representative to enable any of the followingservices

1 Payment Tokenization Required by the Module for Credit Card processing

2 Decision Manager

3 Payer Authentication

4 PayPal Express Checkout New credentials are required for Alt Pay connection Additional setupin PayPal is documented in the PayPal guide listed in Section 6 of this document

5 eChecks

6 Online Bank Transfers

7 Tax Calculation

8 Klarna

9 Account Takeover Protection

10 Account Updater

11 Visa Checkout (enabled in the EBC)

12 Apple Pay (enabled in the EBC)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 24

3 Magento Backend Configuration Settings

Once logged into the administration section of your Magento 2 website the configuration panel isfound by navigating to the following screen

Stores gt Configuration gt Sales gt Payment Methods

Once on that screen you will see the settings for the CyberSource module Inside this panel areadditional sub panels

25

Figure 31 Main CyberSource configuration panel with sub panels

Oct 07 2019 CyberSource Global Payment Management for Magento 2 26

31 General Settings

Figure 32 General Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 27

Figure 33 General Settings (continued)

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of Secure Acceptance

payment method for credit cards This is used for both Web Mobileand Silent Order Post configurations

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 28

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 14: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Note Decision Manager and related settings are required only if you use Decision Manager

213 Payment Settings

In this section you can specify which card types are allowed for the payment method You can alsoselect currency CVN Display CVN Required and Payer Authentication options

Note In order to enable PayPal Express Checkout payments just enable and configure it in Magentosettings not here The extension implements PayPal payments natively See Section 310

Oct 07 2019 CyberSource Global Payment Management for Magento 2 11

Figure 24 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Settings

214 Security

In the Security panel you will create an Access Key and a Secret Key needed to complete the setup ofthe Magento 2 Module See Section 34 and Section 39

Oct 07 2019 CyberSource Global Payment Management for Magento 2 12

Figure 25 CyberSource Business Center Secure Acceptance Profiles Configuration - Security Settings

If you still donrsquot have any keys generated click on lsquo+rsquo button and create a new key

Figure 26 CyberSource Business Center Secure Acceptance Profiles Configuration - Key Creation

215 Payment Form

If using Secure Acceptance Hosted Checkout (WebMobile) when a customer is either redirected tothe hosted payment page at CyberSource or if they see the modal popup window during checkoutthey will see a payment form that has been configured with the settings below These settings are notapplicable for the Secure Acceptance Checkout API (Silent Order POST) configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 13

Figure 27 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Form Set-ting

These settings have no effect on the integration with Magento and can be configured to your specificneeds

216 Notifications

On this configuration panel you must choose the Merchant POST URL tick box and input callback URLto your store

Oct 07 2019 CyberSource Global Payment Management for Magento 2 14

Figure 28 CyberSource Business Center Secure Acceptance Profiles Configuration - Notifications Set-tings

The Merchant POST URL is ltyour base urlgt + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Merchant POST URL would behttpwwwexamplecomcybersourceindexplaceOrder

When you configure a Merchant POST URL you will also see additional settings for the card digitsreturned and stored in Magento

217 Customer Response

Response pages are URLrsquos that customers get directed to when a transaction is completed or has beencancelled

Oct 07 2019 CyberSource Global Payment Management for Magento 2 15

Figure 29 CyberSource Business Center Secure Acceptance Profiles Configuration - Customer ResponseConfiguration

Your Transaction Response page URL is your base url + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexplaceOrder

Your Custom Cancel Response Page URL is your base url + cybersourceindexcancel

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexcancel

Oct 07 2019 CyberSource Global Payment Management for Magento 2 16

218 Branding

In this section you can customize look and feel of the Hosted Checkout page It doesnrsquot affect Magentointegration directly These settings are not applicable for the Secure Acceptance Checkout API (SilentOrder POST)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 17

22 Decision Manager

For the purposes of configuring Magento to work with Decision Manager the following sections out-line some brief topics that help describe how Magento and Decision Manger will work together

221 Orders

When enabled Decision Manager runs in real time with the Authorization The possible decisions areACCEPT REJECT REVIEW or ERROR Orders set to REVIEW by Decision Manager will be marked asPending Review in Magento

When you change an order in Decision Manager Case Management from REVIEW to REJECT or AC-CEPT Magento will not immediately learn of this change Magento will learn of any changes to pay-ment transaction states periodically (by cron every 2 minutes) by contacting CyberSource and query-ing for changes Section 36 describes how you configure Magento Cron settings that will trigger aMagento task that will look for Decision Manager changes and update Magento Orders accordingly

If a change in state is detected the module will update the order status in Magento from PendingReview to one of these states Processing Pending Payment or Closed

Please note that if an order is Pending Review in Decision Manager you cannot prepare an invoice inMagento until it is accepted in Decision Manager

222 Refunds

Please note the order must be either Accepted or Rejected in Decision Manager before you are ableto issue a refund Rejecting an order in Decision Manager will automatically perform an AuthorizationReversal for the order as part of the Cron process that queries CyberSource for updates in DecisionManager

223 Custom Fields

Decision Manager supports up to 100 custom fields called Merchant Defined Data Fields The Cy-berSource Module for Magento 2 will send ten of these fields but they must be configured insideDecision Manager in order to make use of them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 18

Figure 210 CyberSource Business Center Decision Manager Custom Fields Configuration

To add the additional custom fields provided by Magento 2 login to the Business Center and navigateto Decision Manager gt Shared Configuration gt Custom Fields Use the tables below to configure thefields

To add a field click the Add Custom Field button select the Order Element and input the name Followthe table below to map the correct element and name

Field Name Order ElementLogged in customer merchant_defined_data1Account creation date merchant_defined_data2Purchase History Count merchant_defined_data3Last Order Date merchant_defined_data4Member account age merchant_defined_data5Repeat customer merchant_defined_data6Coupon Code Used merchant_defined_data20Discount Amount merchant_defined_data21Gift Message merchant_defined_data22Order Source merchant_defined_data23Shipping Method Code merchant_defined_data31Shipping Method Description merchant_defined_data32

For complete Decision Manager configuration instructions please refer to the CyberSource DecisionManager User Guide referenced in Section 6 of this manual

Oct 07 2019 CyberSource Global Payment Management for Magento 2 19

23 Security Credentials

In addition to the Secure Acceptance security credentials created in Section 21 the module usesother connection methods to access CyberSource services that require their own security credentialsfor authentication

Note Configuring of SOAP Toolkit Key is mandatory for this extension proper functioning

231 Create a SOAP Toolkit Key

The CyberSource Module for Magento makes use of the SOAP Toolkit API to access several Cyber-Source services that do not include the transmission of card data

To create a SOAP Toolkit API transaction key navigate in the Enterprise Business Center to PaymentConfiguration gt Key Management

1 Click the ldquoGenerate Keyrdquo button

2 Select the ldquoTransaction processingrdquo key type and click ldquoNext Steprdquo

3 Select the ldquoSOAPrdquo as key subtype and click ldquoSubmitrdquo

4 Save the resulting key for purposes of entering in your Magento configuration

Figure 211 Create a Transaction Security Key - Selecting Key Type

Oct 07 2019 CyberSource Global Payment Management for Magento 2 20

Figure 212 Create a Transaction Security Key - Selecting Key Subtype

Figure 213 Create a Transaction Security Key - Generated SOAP Toolkit Key

Oct 07 2019 CyberSource Global Payment Management for Magento 2 21

232 Create a Report Download User

The CyberSourceModule for Magento uses a reporting API that allowsMagento to query CyberSourcefor information about transactions To activate this you must create a separate CyberSource BusinessCenter user with the role of ldquoReport Downloadrdquo

Figure 214 CyberSource Business Center Main Navigation - User Administration

Navigate to the Account Management gt User Administration section of the main navigation Thescreen will show a listing of active users Click the ldquoAdd Userrdquo button The next screen will look likethis

Oct 07 2019 CyberSource Global Payment Management for Magento 2 22

Figure 215 Add New CyberSource Business Center User Screen

Fill out the form and select lsquoReport Downloadrsquo User Role Once you complete the Add User form anemail will be sent to the address used on the form The email will contain a link and a onetime lsquotokenrsquoused to validate the email account Once the token is entered you will be asked to reset the passwordThis password is needed in Section 31 for the lsquoReport Passwordrsquo

Oct 07 2019 CyberSource Global Payment Management for Magento 2 23

24 Backend Setup

Certain CyberSource services supported by the Module require additional backend setup on yourMerchant ID Please contact your CyberSource Account Representative to enable any of the followingservices

1 Payment Tokenization Required by the Module for Credit Card processing

2 Decision Manager

3 Payer Authentication

4 PayPal Express Checkout New credentials are required for Alt Pay connection Additional setupin PayPal is documented in the PayPal guide listed in Section 6 of this document

5 eChecks

6 Online Bank Transfers

7 Tax Calculation

8 Klarna

9 Account Takeover Protection

10 Account Updater

11 Visa Checkout (enabled in the EBC)

12 Apple Pay (enabled in the EBC)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 24

3 Magento Backend Configuration Settings

Once logged into the administration section of your Magento 2 website the configuration panel isfound by navigating to the following screen

Stores gt Configuration gt Sales gt Payment Methods

Once on that screen you will see the settings for the CyberSource module Inside this panel areadditional sub panels

25

Figure 31 Main CyberSource configuration panel with sub panels

Oct 07 2019 CyberSource Global Payment Management for Magento 2 26

31 General Settings

Figure 32 General Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 27

Figure 33 General Settings (continued)

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of Secure Acceptance

payment method for credit cards This is used for both Web Mobileand Silent Order Post configurations

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 28

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 15: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Figure 24 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Settings

214 Security

In the Security panel you will create an Access Key and a Secret Key needed to complete the setup ofthe Magento 2 Module See Section 34 and Section 39

Oct 07 2019 CyberSource Global Payment Management for Magento 2 12

Figure 25 CyberSource Business Center Secure Acceptance Profiles Configuration - Security Settings

If you still donrsquot have any keys generated click on lsquo+rsquo button and create a new key

Figure 26 CyberSource Business Center Secure Acceptance Profiles Configuration - Key Creation

215 Payment Form

If using Secure Acceptance Hosted Checkout (WebMobile) when a customer is either redirected tothe hosted payment page at CyberSource or if they see the modal popup window during checkoutthey will see a payment form that has been configured with the settings below These settings are notapplicable for the Secure Acceptance Checkout API (Silent Order POST) configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 13

Figure 27 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Form Set-ting

These settings have no effect on the integration with Magento and can be configured to your specificneeds

216 Notifications

On this configuration panel you must choose the Merchant POST URL tick box and input callback URLto your store

Oct 07 2019 CyberSource Global Payment Management for Magento 2 14

Figure 28 CyberSource Business Center Secure Acceptance Profiles Configuration - Notifications Set-tings

The Merchant POST URL is ltyour base urlgt + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Merchant POST URL would behttpwwwexamplecomcybersourceindexplaceOrder

When you configure a Merchant POST URL you will also see additional settings for the card digitsreturned and stored in Magento

217 Customer Response

Response pages are URLrsquos that customers get directed to when a transaction is completed or has beencancelled

Oct 07 2019 CyberSource Global Payment Management for Magento 2 15

Figure 29 CyberSource Business Center Secure Acceptance Profiles Configuration - Customer ResponseConfiguration

Your Transaction Response page URL is your base url + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexplaceOrder

Your Custom Cancel Response Page URL is your base url + cybersourceindexcancel

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexcancel

Oct 07 2019 CyberSource Global Payment Management for Magento 2 16

218 Branding

In this section you can customize look and feel of the Hosted Checkout page It doesnrsquot affect Magentointegration directly These settings are not applicable for the Secure Acceptance Checkout API (SilentOrder POST)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 17

22 Decision Manager

For the purposes of configuring Magento to work with Decision Manager the following sections out-line some brief topics that help describe how Magento and Decision Manger will work together

221 Orders

When enabled Decision Manager runs in real time with the Authorization The possible decisions areACCEPT REJECT REVIEW or ERROR Orders set to REVIEW by Decision Manager will be marked asPending Review in Magento

When you change an order in Decision Manager Case Management from REVIEW to REJECT or AC-CEPT Magento will not immediately learn of this change Magento will learn of any changes to pay-ment transaction states periodically (by cron every 2 minutes) by contacting CyberSource and query-ing for changes Section 36 describes how you configure Magento Cron settings that will trigger aMagento task that will look for Decision Manager changes and update Magento Orders accordingly

If a change in state is detected the module will update the order status in Magento from PendingReview to one of these states Processing Pending Payment or Closed

Please note that if an order is Pending Review in Decision Manager you cannot prepare an invoice inMagento until it is accepted in Decision Manager

222 Refunds

Please note the order must be either Accepted or Rejected in Decision Manager before you are ableto issue a refund Rejecting an order in Decision Manager will automatically perform an AuthorizationReversal for the order as part of the Cron process that queries CyberSource for updates in DecisionManager

223 Custom Fields

Decision Manager supports up to 100 custom fields called Merchant Defined Data Fields The Cy-berSource Module for Magento 2 will send ten of these fields but they must be configured insideDecision Manager in order to make use of them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 18

Figure 210 CyberSource Business Center Decision Manager Custom Fields Configuration

To add the additional custom fields provided by Magento 2 login to the Business Center and navigateto Decision Manager gt Shared Configuration gt Custom Fields Use the tables below to configure thefields

To add a field click the Add Custom Field button select the Order Element and input the name Followthe table below to map the correct element and name

Field Name Order ElementLogged in customer merchant_defined_data1Account creation date merchant_defined_data2Purchase History Count merchant_defined_data3Last Order Date merchant_defined_data4Member account age merchant_defined_data5Repeat customer merchant_defined_data6Coupon Code Used merchant_defined_data20Discount Amount merchant_defined_data21Gift Message merchant_defined_data22Order Source merchant_defined_data23Shipping Method Code merchant_defined_data31Shipping Method Description merchant_defined_data32

For complete Decision Manager configuration instructions please refer to the CyberSource DecisionManager User Guide referenced in Section 6 of this manual

Oct 07 2019 CyberSource Global Payment Management for Magento 2 19

23 Security Credentials

In addition to the Secure Acceptance security credentials created in Section 21 the module usesother connection methods to access CyberSource services that require their own security credentialsfor authentication

Note Configuring of SOAP Toolkit Key is mandatory for this extension proper functioning

231 Create a SOAP Toolkit Key

The CyberSource Module for Magento makes use of the SOAP Toolkit API to access several Cyber-Source services that do not include the transmission of card data

To create a SOAP Toolkit API transaction key navigate in the Enterprise Business Center to PaymentConfiguration gt Key Management

1 Click the ldquoGenerate Keyrdquo button

2 Select the ldquoTransaction processingrdquo key type and click ldquoNext Steprdquo

3 Select the ldquoSOAPrdquo as key subtype and click ldquoSubmitrdquo

4 Save the resulting key for purposes of entering in your Magento configuration

Figure 211 Create a Transaction Security Key - Selecting Key Type

Oct 07 2019 CyberSource Global Payment Management for Magento 2 20

Figure 212 Create a Transaction Security Key - Selecting Key Subtype

Figure 213 Create a Transaction Security Key - Generated SOAP Toolkit Key

Oct 07 2019 CyberSource Global Payment Management for Magento 2 21

232 Create a Report Download User

The CyberSourceModule for Magento uses a reporting API that allowsMagento to query CyberSourcefor information about transactions To activate this you must create a separate CyberSource BusinessCenter user with the role of ldquoReport Downloadrdquo

Figure 214 CyberSource Business Center Main Navigation - User Administration

Navigate to the Account Management gt User Administration section of the main navigation Thescreen will show a listing of active users Click the ldquoAdd Userrdquo button The next screen will look likethis

Oct 07 2019 CyberSource Global Payment Management for Magento 2 22

Figure 215 Add New CyberSource Business Center User Screen

Fill out the form and select lsquoReport Downloadrsquo User Role Once you complete the Add User form anemail will be sent to the address used on the form The email will contain a link and a onetime lsquotokenrsquoused to validate the email account Once the token is entered you will be asked to reset the passwordThis password is needed in Section 31 for the lsquoReport Passwordrsquo

Oct 07 2019 CyberSource Global Payment Management for Magento 2 23

24 Backend Setup

Certain CyberSource services supported by the Module require additional backend setup on yourMerchant ID Please contact your CyberSource Account Representative to enable any of the followingservices

1 Payment Tokenization Required by the Module for Credit Card processing

2 Decision Manager

3 Payer Authentication

4 PayPal Express Checkout New credentials are required for Alt Pay connection Additional setupin PayPal is documented in the PayPal guide listed in Section 6 of this document

5 eChecks

6 Online Bank Transfers

7 Tax Calculation

8 Klarna

9 Account Takeover Protection

10 Account Updater

11 Visa Checkout (enabled in the EBC)

12 Apple Pay (enabled in the EBC)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 24

3 Magento Backend Configuration Settings

Once logged into the administration section of your Magento 2 website the configuration panel isfound by navigating to the following screen

Stores gt Configuration gt Sales gt Payment Methods

Once on that screen you will see the settings for the CyberSource module Inside this panel areadditional sub panels

25

Figure 31 Main CyberSource configuration panel with sub panels

Oct 07 2019 CyberSource Global Payment Management for Magento 2 26

31 General Settings

Figure 32 General Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 27

Figure 33 General Settings (continued)

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of Secure Acceptance

payment method for credit cards This is used for both Web Mobileand Silent Order Post configurations

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 28

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 16: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Figure 25 CyberSource Business Center Secure Acceptance Profiles Configuration - Security Settings

If you still donrsquot have any keys generated click on lsquo+rsquo button and create a new key

Figure 26 CyberSource Business Center Secure Acceptance Profiles Configuration - Key Creation

215 Payment Form

If using Secure Acceptance Hosted Checkout (WebMobile) when a customer is either redirected tothe hosted payment page at CyberSource or if they see the modal popup window during checkoutthey will see a payment form that has been configured with the settings below These settings are notapplicable for the Secure Acceptance Checkout API (Silent Order POST) configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 13

Figure 27 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Form Set-ting

These settings have no effect on the integration with Magento and can be configured to your specificneeds

216 Notifications

On this configuration panel you must choose the Merchant POST URL tick box and input callback URLto your store

Oct 07 2019 CyberSource Global Payment Management for Magento 2 14

Figure 28 CyberSource Business Center Secure Acceptance Profiles Configuration - Notifications Set-tings

The Merchant POST URL is ltyour base urlgt + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Merchant POST URL would behttpwwwexamplecomcybersourceindexplaceOrder

When you configure a Merchant POST URL you will also see additional settings for the card digitsreturned and stored in Magento

217 Customer Response

Response pages are URLrsquos that customers get directed to when a transaction is completed or has beencancelled

Oct 07 2019 CyberSource Global Payment Management for Magento 2 15

Figure 29 CyberSource Business Center Secure Acceptance Profiles Configuration - Customer ResponseConfiguration

Your Transaction Response page URL is your base url + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexplaceOrder

Your Custom Cancel Response Page URL is your base url + cybersourceindexcancel

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexcancel

Oct 07 2019 CyberSource Global Payment Management for Magento 2 16

218 Branding

In this section you can customize look and feel of the Hosted Checkout page It doesnrsquot affect Magentointegration directly These settings are not applicable for the Secure Acceptance Checkout API (SilentOrder POST)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 17

22 Decision Manager

For the purposes of configuring Magento to work with Decision Manager the following sections out-line some brief topics that help describe how Magento and Decision Manger will work together

221 Orders

When enabled Decision Manager runs in real time with the Authorization The possible decisions areACCEPT REJECT REVIEW or ERROR Orders set to REVIEW by Decision Manager will be marked asPending Review in Magento

When you change an order in Decision Manager Case Management from REVIEW to REJECT or AC-CEPT Magento will not immediately learn of this change Magento will learn of any changes to pay-ment transaction states periodically (by cron every 2 minutes) by contacting CyberSource and query-ing for changes Section 36 describes how you configure Magento Cron settings that will trigger aMagento task that will look for Decision Manager changes and update Magento Orders accordingly

If a change in state is detected the module will update the order status in Magento from PendingReview to one of these states Processing Pending Payment or Closed

Please note that if an order is Pending Review in Decision Manager you cannot prepare an invoice inMagento until it is accepted in Decision Manager

222 Refunds

Please note the order must be either Accepted or Rejected in Decision Manager before you are ableto issue a refund Rejecting an order in Decision Manager will automatically perform an AuthorizationReversal for the order as part of the Cron process that queries CyberSource for updates in DecisionManager

223 Custom Fields

Decision Manager supports up to 100 custom fields called Merchant Defined Data Fields The Cy-berSource Module for Magento 2 will send ten of these fields but they must be configured insideDecision Manager in order to make use of them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 18

Figure 210 CyberSource Business Center Decision Manager Custom Fields Configuration

To add the additional custom fields provided by Magento 2 login to the Business Center and navigateto Decision Manager gt Shared Configuration gt Custom Fields Use the tables below to configure thefields

To add a field click the Add Custom Field button select the Order Element and input the name Followthe table below to map the correct element and name

Field Name Order ElementLogged in customer merchant_defined_data1Account creation date merchant_defined_data2Purchase History Count merchant_defined_data3Last Order Date merchant_defined_data4Member account age merchant_defined_data5Repeat customer merchant_defined_data6Coupon Code Used merchant_defined_data20Discount Amount merchant_defined_data21Gift Message merchant_defined_data22Order Source merchant_defined_data23Shipping Method Code merchant_defined_data31Shipping Method Description merchant_defined_data32

For complete Decision Manager configuration instructions please refer to the CyberSource DecisionManager User Guide referenced in Section 6 of this manual

Oct 07 2019 CyberSource Global Payment Management for Magento 2 19

23 Security Credentials

In addition to the Secure Acceptance security credentials created in Section 21 the module usesother connection methods to access CyberSource services that require their own security credentialsfor authentication

Note Configuring of SOAP Toolkit Key is mandatory for this extension proper functioning

231 Create a SOAP Toolkit Key

The CyberSource Module for Magento makes use of the SOAP Toolkit API to access several Cyber-Source services that do not include the transmission of card data

To create a SOAP Toolkit API transaction key navigate in the Enterprise Business Center to PaymentConfiguration gt Key Management

1 Click the ldquoGenerate Keyrdquo button

2 Select the ldquoTransaction processingrdquo key type and click ldquoNext Steprdquo

3 Select the ldquoSOAPrdquo as key subtype and click ldquoSubmitrdquo

4 Save the resulting key for purposes of entering in your Magento configuration

Figure 211 Create a Transaction Security Key - Selecting Key Type

Oct 07 2019 CyberSource Global Payment Management for Magento 2 20

Figure 212 Create a Transaction Security Key - Selecting Key Subtype

Figure 213 Create a Transaction Security Key - Generated SOAP Toolkit Key

Oct 07 2019 CyberSource Global Payment Management for Magento 2 21

232 Create a Report Download User

The CyberSourceModule for Magento uses a reporting API that allowsMagento to query CyberSourcefor information about transactions To activate this you must create a separate CyberSource BusinessCenter user with the role of ldquoReport Downloadrdquo

Figure 214 CyberSource Business Center Main Navigation - User Administration

Navigate to the Account Management gt User Administration section of the main navigation Thescreen will show a listing of active users Click the ldquoAdd Userrdquo button The next screen will look likethis

Oct 07 2019 CyberSource Global Payment Management for Magento 2 22

Figure 215 Add New CyberSource Business Center User Screen

Fill out the form and select lsquoReport Downloadrsquo User Role Once you complete the Add User form anemail will be sent to the address used on the form The email will contain a link and a onetime lsquotokenrsquoused to validate the email account Once the token is entered you will be asked to reset the passwordThis password is needed in Section 31 for the lsquoReport Passwordrsquo

Oct 07 2019 CyberSource Global Payment Management for Magento 2 23

24 Backend Setup

Certain CyberSource services supported by the Module require additional backend setup on yourMerchant ID Please contact your CyberSource Account Representative to enable any of the followingservices

1 Payment Tokenization Required by the Module for Credit Card processing

2 Decision Manager

3 Payer Authentication

4 PayPal Express Checkout New credentials are required for Alt Pay connection Additional setupin PayPal is documented in the PayPal guide listed in Section 6 of this document

5 eChecks

6 Online Bank Transfers

7 Tax Calculation

8 Klarna

9 Account Takeover Protection

10 Account Updater

11 Visa Checkout (enabled in the EBC)

12 Apple Pay (enabled in the EBC)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 24

3 Magento Backend Configuration Settings

Once logged into the administration section of your Magento 2 website the configuration panel isfound by navigating to the following screen

Stores gt Configuration gt Sales gt Payment Methods

Once on that screen you will see the settings for the CyberSource module Inside this panel areadditional sub panels

25

Figure 31 Main CyberSource configuration panel with sub panels

Oct 07 2019 CyberSource Global Payment Management for Magento 2 26

31 General Settings

Figure 32 General Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 27

Figure 33 General Settings (continued)

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of Secure Acceptance

payment method for credit cards This is used for both Web Mobileand Silent Order Post configurations

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 28

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 17: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Figure 27 CyberSource Business Center Secure Acceptance Profiles Configuration - Payment Form Set-ting

These settings have no effect on the integration with Magento and can be configured to your specificneeds

216 Notifications

On this configuration panel you must choose the Merchant POST URL tick box and input callback URLto your store

Oct 07 2019 CyberSource Global Payment Management for Magento 2 14

Figure 28 CyberSource Business Center Secure Acceptance Profiles Configuration - Notifications Set-tings

The Merchant POST URL is ltyour base urlgt + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Merchant POST URL would behttpwwwexamplecomcybersourceindexplaceOrder

When you configure a Merchant POST URL you will also see additional settings for the card digitsreturned and stored in Magento

217 Customer Response

Response pages are URLrsquos that customers get directed to when a transaction is completed or has beencancelled

Oct 07 2019 CyberSource Global Payment Management for Magento 2 15

Figure 29 CyberSource Business Center Secure Acceptance Profiles Configuration - Customer ResponseConfiguration

Your Transaction Response page URL is your base url + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexplaceOrder

Your Custom Cancel Response Page URL is your base url + cybersourceindexcancel

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexcancel

Oct 07 2019 CyberSource Global Payment Management for Magento 2 16

218 Branding

In this section you can customize look and feel of the Hosted Checkout page It doesnrsquot affect Magentointegration directly These settings are not applicable for the Secure Acceptance Checkout API (SilentOrder POST)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 17

22 Decision Manager

For the purposes of configuring Magento to work with Decision Manager the following sections out-line some brief topics that help describe how Magento and Decision Manger will work together

221 Orders

When enabled Decision Manager runs in real time with the Authorization The possible decisions areACCEPT REJECT REVIEW or ERROR Orders set to REVIEW by Decision Manager will be marked asPending Review in Magento

When you change an order in Decision Manager Case Management from REVIEW to REJECT or AC-CEPT Magento will not immediately learn of this change Magento will learn of any changes to pay-ment transaction states periodically (by cron every 2 minutes) by contacting CyberSource and query-ing for changes Section 36 describes how you configure Magento Cron settings that will trigger aMagento task that will look for Decision Manager changes and update Magento Orders accordingly

If a change in state is detected the module will update the order status in Magento from PendingReview to one of these states Processing Pending Payment or Closed

Please note that if an order is Pending Review in Decision Manager you cannot prepare an invoice inMagento until it is accepted in Decision Manager

222 Refunds

Please note the order must be either Accepted or Rejected in Decision Manager before you are ableto issue a refund Rejecting an order in Decision Manager will automatically perform an AuthorizationReversal for the order as part of the Cron process that queries CyberSource for updates in DecisionManager

223 Custom Fields

Decision Manager supports up to 100 custom fields called Merchant Defined Data Fields The Cy-berSource Module for Magento 2 will send ten of these fields but they must be configured insideDecision Manager in order to make use of them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 18

Figure 210 CyberSource Business Center Decision Manager Custom Fields Configuration

To add the additional custom fields provided by Magento 2 login to the Business Center and navigateto Decision Manager gt Shared Configuration gt Custom Fields Use the tables below to configure thefields

To add a field click the Add Custom Field button select the Order Element and input the name Followthe table below to map the correct element and name

Field Name Order ElementLogged in customer merchant_defined_data1Account creation date merchant_defined_data2Purchase History Count merchant_defined_data3Last Order Date merchant_defined_data4Member account age merchant_defined_data5Repeat customer merchant_defined_data6Coupon Code Used merchant_defined_data20Discount Amount merchant_defined_data21Gift Message merchant_defined_data22Order Source merchant_defined_data23Shipping Method Code merchant_defined_data31Shipping Method Description merchant_defined_data32

For complete Decision Manager configuration instructions please refer to the CyberSource DecisionManager User Guide referenced in Section 6 of this manual

Oct 07 2019 CyberSource Global Payment Management for Magento 2 19

23 Security Credentials

In addition to the Secure Acceptance security credentials created in Section 21 the module usesother connection methods to access CyberSource services that require their own security credentialsfor authentication

Note Configuring of SOAP Toolkit Key is mandatory for this extension proper functioning

231 Create a SOAP Toolkit Key

The CyberSource Module for Magento makes use of the SOAP Toolkit API to access several Cyber-Source services that do not include the transmission of card data

To create a SOAP Toolkit API transaction key navigate in the Enterprise Business Center to PaymentConfiguration gt Key Management

1 Click the ldquoGenerate Keyrdquo button

2 Select the ldquoTransaction processingrdquo key type and click ldquoNext Steprdquo

3 Select the ldquoSOAPrdquo as key subtype and click ldquoSubmitrdquo

4 Save the resulting key for purposes of entering in your Magento configuration

Figure 211 Create a Transaction Security Key - Selecting Key Type

Oct 07 2019 CyberSource Global Payment Management for Magento 2 20

Figure 212 Create a Transaction Security Key - Selecting Key Subtype

Figure 213 Create a Transaction Security Key - Generated SOAP Toolkit Key

Oct 07 2019 CyberSource Global Payment Management for Magento 2 21

232 Create a Report Download User

The CyberSourceModule for Magento uses a reporting API that allowsMagento to query CyberSourcefor information about transactions To activate this you must create a separate CyberSource BusinessCenter user with the role of ldquoReport Downloadrdquo

Figure 214 CyberSource Business Center Main Navigation - User Administration

Navigate to the Account Management gt User Administration section of the main navigation Thescreen will show a listing of active users Click the ldquoAdd Userrdquo button The next screen will look likethis

Oct 07 2019 CyberSource Global Payment Management for Magento 2 22

Figure 215 Add New CyberSource Business Center User Screen

Fill out the form and select lsquoReport Downloadrsquo User Role Once you complete the Add User form anemail will be sent to the address used on the form The email will contain a link and a onetime lsquotokenrsquoused to validate the email account Once the token is entered you will be asked to reset the passwordThis password is needed in Section 31 for the lsquoReport Passwordrsquo

Oct 07 2019 CyberSource Global Payment Management for Magento 2 23

24 Backend Setup

Certain CyberSource services supported by the Module require additional backend setup on yourMerchant ID Please contact your CyberSource Account Representative to enable any of the followingservices

1 Payment Tokenization Required by the Module for Credit Card processing

2 Decision Manager

3 Payer Authentication

4 PayPal Express Checkout New credentials are required for Alt Pay connection Additional setupin PayPal is documented in the PayPal guide listed in Section 6 of this document

5 eChecks

6 Online Bank Transfers

7 Tax Calculation

8 Klarna

9 Account Takeover Protection

10 Account Updater

11 Visa Checkout (enabled in the EBC)

12 Apple Pay (enabled in the EBC)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 24

3 Magento Backend Configuration Settings

Once logged into the administration section of your Magento 2 website the configuration panel isfound by navigating to the following screen

Stores gt Configuration gt Sales gt Payment Methods

Once on that screen you will see the settings for the CyberSource module Inside this panel areadditional sub panels

25

Figure 31 Main CyberSource configuration panel with sub panels

Oct 07 2019 CyberSource Global Payment Management for Magento 2 26

31 General Settings

Figure 32 General Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 27

Figure 33 General Settings (continued)

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of Secure Acceptance

payment method for credit cards This is used for both Web Mobileand Silent Order Post configurations

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 28

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 18: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Figure 28 CyberSource Business Center Secure Acceptance Profiles Configuration - Notifications Set-tings

The Merchant POST URL is ltyour base urlgt + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Merchant POST URL would behttpwwwexamplecomcybersourceindexplaceOrder

When you configure a Merchant POST URL you will also see additional settings for the card digitsreturned and stored in Magento

217 Customer Response

Response pages are URLrsquos that customers get directed to when a transaction is completed or has beencancelled

Oct 07 2019 CyberSource Global Payment Management for Magento 2 15

Figure 29 CyberSource Business Center Secure Acceptance Profiles Configuration - Customer ResponseConfiguration

Your Transaction Response page URL is your base url + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexplaceOrder

Your Custom Cancel Response Page URL is your base url + cybersourceindexcancel

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexcancel

Oct 07 2019 CyberSource Global Payment Management for Magento 2 16

218 Branding

In this section you can customize look and feel of the Hosted Checkout page It doesnrsquot affect Magentointegration directly These settings are not applicable for the Secure Acceptance Checkout API (SilentOrder POST)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 17

22 Decision Manager

For the purposes of configuring Magento to work with Decision Manager the following sections out-line some brief topics that help describe how Magento and Decision Manger will work together

221 Orders

When enabled Decision Manager runs in real time with the Authorization The possible decisions areACCEPT REJECT REVIEW or ERROR Orders set to REVIEW by Decision Manager will be marked asPending Review in Magento

When you change an order in Decision Manager Case Management from REVIEW to REJECT or AC-CEPT Magento will not immediately learn of this change Magento will learn of any changes to pay-ment transaction states periodically (by cron every 2 minutes) by contacting CyberSource and query-ing for changes Section 36 describes how you configure Magento Cron settings that will trigger aMagento task that will look for Decision Manager changes and update Magento Orders accordingly

If a change in state is detected the module will update the order status in Magento from PendingReview to one of these states Processing Pending Payment or Closed

Please note that if an order is Pending Review in Decision Manager you cannot prepare an invoice inMagento until it is accepted in Decision Manager

222 Refunds

Please note the order must be either Accepted or Rejected in Decision Manager before you are ableto issue a refund Rejecting an order in Decision Manager will automatically perform an AuthorizationReversal for the order as part of the Cron process that queries CyberSource for updates in DecisionManager

223 Custom Fields

Decision Manager supports up to 100 custom fields called Merchant Defined Data Fields The Cy-berSource Module for Magento 2 will send ten of these fields but they must be configured insideDecision Manager in order to make use of them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 18

Figure 210 CyberSource Business Center Decision Manager Custom Fields Configuration

To add the additional custom fields provided by Magento 2 login to the Business Center and navigateto Decision Manager gt Shared Configuration gt Custom Fields Use the tables below to configure thefields

To add a field click the Add Custom Field button select the Order Element and input the name Followthe table below to map the correct element and name

Field Name Order ElementLogged in customer merchant_defined_data1Account creation date merchant_defined_data2Purchase History Count merchant_defined_data3Last Order Date merchant_defined_data4Member account age merchant_defined_data5Repeat customer merchant_defined_data6Coupon Code Used merchant_defined_data20Discount Amount merchant_defined_data21Gift Message merchant_defined_data22Order Source merchant_defined_data23Shipping Method Code merchant_defined_data31Shipping Method Description merchant_defined_data32

For complete Decision Manager configuration instructions please refer to the CyberSource DecisionManager User Guide referenced in Section 6 of this manual

Oct 07 2019 CyberSource Global Payment Management for Magento 2 19

23 Security Credentials

In addition to the Secure Acceptance security credentials created in Section 21 the module usesother connection methods to access CyberSource services that require their own security credentialsfor authentication

Note Configuring of SOAP Toolkit Key is mandatory for this extension proper functioning

231 Create a SOAP Toolkit Key

The CyberSource Module for Magento makes use of the SOAP Toolkit API to access several Cyber-Source services that do not include the transmission of card data

To create a SOAP Toolkit API transaction key navigate in the Enterprise Business Center to PaymentConfiguration gt Key Management

1 Click the ldquoGenerate Keyrdquo button

2 Select the ldquoTransaction processingrdquo key type and click ldquoNext Steprdquo

3 Select the ldquoSOAPrdquo as key subtype and click ldquoSubmitrdquo

4 Save the resulting key for purposes of entering in your Magento configuration

Figure 211 Create a Transaction Security Key - Selecting Key Type

Oct 07 2019 CyberSource Global Payment Management for Magento 2 20

Figure 212 Create a Transaction Security Key - Selecting Key Subtype

Figure 213 Create a Transaction Security Key - Generated SOAP Toolkit Key

Oct 07 2019 CyberSource Global Payment Management for Magento 2 21

232 Create a Report Download User

The CyberSourceModule for Magento uses a reporting API that allowsMagento to query CyberSourcefor information about transactions To activate this you must create a separate CyberSource BusinessCenter user with the role of ldquoReport Downloadrdquo

Figure 214 CyberSource Business Center Main Navigation - User Administration

Navigate to the Account Management gt User Administration section of the main navigation Thescreen will show a listing of active users Click the ldquoAdd Userrdquo button The next screen will look likethis

Oct 07 2019 CyberSource Global Payment Management for Magento 2 22

Figure 215 Add New CyberSource Business Center User Screen

Fill out the form and select lsquoReport Downloadrsquo User Role Once you complete the Add User form anemail will be sent to the address used on the form The email will contain a link and a onetime lsquotokenrsquoused to validate the email account Once the token is entered you will be asked to reset the passwordThis password is needed in Section 31 for the lsquoReport Passwordrsquo

Oct 07 2019 CyberSource Global Payment Management for Magento 2 23

24 Backend Setup

Certain CyberSource services supported by the Module require additional backend setup on yourMerchant ID Please contact your CyberSource Account Representative to enable any of the followingservices

1 Payment Tokenization Required by the Module for Credit Card processing

2 Decision Manager

3 Payer Authentication

4 PayPal Express Checkout New credentials are required for Alt Pay connection Additional setupin PayPal is documented in the PayPal guide listed in Section 6 of this document

5 eChecks

6 Online Bank Transfers

7 Tax Calculation

8 Klarna

9 Account Takeover Protection

10 Account Updater

11 Visa Checkout (enabled in the EBC)

12 Apple Pay (enabled in the EBC)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 24

3 Magento Backend Configuration Settings

Once logged into the administration section of your Magento 2 website the configuration panel isfound by navigating to the following screen

Stores gt Configuration gt Sales gt Payment Methods

Once on that screen you will see the settings for the CyberSource module Inside this panel areadditional sub panels

25

Figure 31 Main CyberSource configuration panel with sub panels

Oct 07 2019 CyberSource Global Payment Management for Magento 2 26

31 General Settings

Figure 32 General Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 27

Figure 33 General Settings (continued)

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of Secure Acceptance

payment method for credit cards This is used for both Web Mobileand Silent Order Post configurations

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 28

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 19: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Figure 29 CyberSource Business Center Secure Acceptance Profiles Configuration - Customer ResponseConfiguration

Your Transaction Response page URL is your base url + cybersourceindexplaceOrder

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexplaceOrder

Your Custom Cancel Response Page URL is your base url + cybersourceindexcancel

For example if your website URL is httpwwwexamplecom then the Transaction Response URLwould be httpwwwexamplecomcybersourceindexcancel

Oct 07 2019 CyberSource Global Payment Management for Magento 2 16

218 Branding

In this section you can customize look and feel of the Hosted Checkout page It doesnrsquot affect Magentointegration directly These settings are not applicable for the Secure Acceptance Checkout API (SilentOrder POST)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 17

22 Decision Manager

For the purposes of configuring Magento to work with Decision Manager the following sections out-line some brief topics that help describe how Magento and Decision Manger will work together

221 Orders

When enabled Decision Manager runs in real time with the Authorization The possible decisions areACCEPT REJECT REVIEW or ERROR Orders set to REVIEW by Decision Manager will be marked asPending Review in Magento

When you change an order in Decision Manager Case Management from REVIEW to REJECT or AC-CEPT Magento will not immediately learn of this change Magento will learn of any changes to pay-ment transaction states periodically (by cron every 2 minutes) by contacting CyberSource and query-ing for changes Section 36 describes how you configure Magento Cron settings that will trigger aMagento task that will look for Decision Manager changes and update Magento Orders accordingly

If a change in state is detected the module will update the order status in Magento from PendingReview to one of these states Processing Pending Payment or Closed

Please note that if an order is Pending Review in Decision Manager you cannot prepare an invoice inMagento until it is accepted in Decision Manager

222 Refunds

Please note the order must be either Accepted or Rejected in Decision Manager before you are ableto issue a refund Rejecting an order in Decision Manager will automatically perform an AuthorizationReversal for the order as part of the Cron process that queries CyberSource for updates in DecisionManager

223 Custom Fields

Decision Manager supports up to 100 custom fields called Merchant Defined Data Fields The Cy-berSource Module for Magento 2 will send ten of these fields but they must be configured insideDecision Manager in order to make use of them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 18

Figure 210 CyberSource Business Center Decision Manager Custom Fields Configuration

To add the additional custom fields provided by Magento 2 login to the Business Center and navigateto Decision Manager gt Shared Configuration gt Custom Fields Use the tables below to configure thefields

To add a field click the Add Custom Field button select the Order Element and input the name Followthe table below to map the correct element and name

Field Name Order ElementLogged in customer merchant_defined_data1Account creation date merchant_defined_data2Purchase History Count merchant_defined_data3Last Order Date merchant_defined_data4Member account age merchant_defined_data5Repeat customer merchant_defined_data6Coupon Code Used merchant_defined_data20Discount Amount merchant_defined_data21Gift Message merchant_defined_data22Order Source merchant_defined_data23Shipping Method Code merchant_defined_data31Shipping Method Description merchant_defined_data32

For complete Decision Manager configuration instructions please refer to the CyberSource DecisionManager User Guide referenced in Section 6 of this manual

Oct 07 2019 CyberSource Global Payment Management for Magento 2 19

23 Security Credentials

In addition to the Secure Acceptance security credentials created in Section 21 the module usesother connection methods to access CyberSource services that require their own security credentialsfor authentication

Note Configuring of SOAP Toolkit Key is mandatory for this extension proper functioning

231 Create a SOAP Toolkit Key

The CyberSource Module for Magento makes use of the SOAP Toolkit API to access several Cyber-Source services that do not include the transmission of card data

To create a SOAP Toolkit API transaction key navigate in the Enterprise Business Center to PaymentConfiguration gt Key Management

1 Click the ldquoGenerate Keyrdquo button

2 Select the ldquoTransaction processingrdquo key type and click ldquoNext Steprdquo

3 Select the ldquoSOAPrdquo as key subtype and click ldquoSubmitrdquo

4 Save the resulting key for purposes of entering in your Magento configuration

Figure 211 Create a Transaction Security Key - Selecting Key Type

Oct 07 2019 CyberSource Global Payment Management for Magento 2 20

Figure 212 Create a Transaction Security Key - Selecting Key Subtype

Figure 213 Create a Transaction Security Key - Generated SOAP Toolkit Key

Oct 07 2019 CyberSource Global Payment Management for Magento 2 21

232 Create a Report Download User

The CyberSourceModule for Magento uses a reporting API that allowsMagento to query CyberSourcefor information about transactions To activate this you must create a separate CyberSource BusinessCenter user with the role of ldquoReport Downloadrdquo

Figure 214 CyberSource Business Center Main Navigation - User Administration

Navigate to the Account Management gt User Administration section of the main navigation Thescreen will show a listing of active users Click the ldquoAdd Userrdquo button The next screen will look likethis

Oct 07 2019 CyberSource Global Payment Management for Magento 2 22

Figure 215 Add New CyberSource Business Center User Screen

Fill out the form and select lsquoReport Downloadrsquo User Role Once you complete the Add User form anemail will be sent to the address used on the form The email will contain a link and a onetime lsquotokenrsquoused to validate the email account Once the token is entered you will be asked to reset the passwordThis password is needed in Section 31 for the lsquoReport Passwordrsquo

Oct 07 2019 CyberSource Global Payment Management for Magento 2 23

24 Backend Setup

Certain CyberSource services supported by the Module require additional backend setup on yourMerchant ID Please contact your CyberSource Account Representative to enable any of the followingservices

1 Payment Tokenization Required by the Module for Credit Card processing

2 Decision Manager

3 Payer Authentication

4 PayPal Express Checkout New credentials are required for Alt Pay connection Additional setupin PayPal is documented in the PayPal guide listed in Section 6 of this document

5 eChecks

6 Online Bank Transfers

7 Tax Calculation

8 Klarna

9 Account Takeover Protection

10 Account Updater

11 Visa Checkout (enabled in the EBC)

12 Apple Pay (enabled in the EBC)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 24

3 Magento Backend Configuration Settings

Once logged into the administration section of your Magento 2 website the configuration panel isfound by navigating to the following screen

Stores gt Configuration gt Sales gt Payment Methods

Once on that screen you will see the settings for the CyberSource module Inside this panel areadditional sub panels

25

Figure 31 Main CyberSource configuration panel with sub panels

Oct 07 2019 CyberSource Global Payment Management for Magento 2 26

31 General Settings

Figure 32 General Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 27

Figure 33 General Settings (continued)

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of Secure Acceptance

payment method for credit cards This is used for both Web Mobileand Silent Order Post configurations

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 28

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 20: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

218 Branding

In this section you can customize look and feel of the Hosted Checkout page It doesnrsquot affect Magentointegration directly These settings are not applicable for the Secure Acceptance Checkout API (SilentOrder POST)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 17

22 Decision Manager

For the purposes of configuring Magento to work with Decision Manager the following sections out-line some brief topics that help describe how Magento and Decision Manger will work together

221 Orders

When enabled Decision Manager runs in real time with the Authorization The possible decisions areACCEPT REJECT REVIEW or ERROR Orders set to REVIEW by Decision Manager will be marked asPending Review in Magento

When you change an order in Decision Manager Case Management from REVIEW to REJECT or AC-CEPT Magento will not immediately learn of this change Magento will learn of any changes to pay-ment transaction states periodically (by cron every 2 minutes) by contacting CyberSource and query-ing for changes Section 36 describes how you configure Magento Cron settings that will trigger aMagento task that will look for Decision Manager changes and update Magento Orders accordingly

If a change in state is detected the module will update the order status in Magento from PendingReview to one of these states Processing Pending Payment or Closed

Please note that if an order is Pending Review in Decision Manager you cannot prepare an invoice inMagento until it is accepted in Decision Manager

222 Refunds

Please note the order must be either Accepted or Rejected in Decision Manager before you are ableto issue a refund Rejecting an order in Decision Manager will automatically perform an AuthorizationReversal for the order as part of the Cron process that queries CyberSource for updates in DecisionManager

223 Custom Fields

Decision Manager supports up to 100 custom fields called Merchant Defined Data Fields The Cy-berSource Module for Magento 2 will send ten of these fields but they must be configured insideDecision Manager in order to make use of them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 18

Figure 210 CyberSource Business Center Decision Manager Custom Fields Configuration

To add the additional custom fields provided by Magento 2 login to the Business Center and navigateto Decision Manager gt Shared Configuration gt Custom Fields Use the tables below to configure thefields

To add a field click the Add Custom Field button select the Order Element and input the name Followthe table below to map the correct element and name

Field Name Order ElementLogged in customer merchant_defined_data1Account creation date merchant_defined_data2Purchase History Count merchant_defined_data3Last Order Date merchant_defined_data4Member account age merchant_defined_data5Repeat customer merchant_defined_data6Coupon Code Used merchant_defined_data20Discount Amount merchant_defined_data21Gift Message merchant_defined_data22Order Source merchant_defined_data23Shipping Method Code merchant_defined_data31Shipping Method Description merchant_defined_data32

For complete Decision Manager configuration instructions please refer to the CyberSource DecisionManager User Guide referenced in Section 6 of this manual

Oct 07 2019 CyberSource Global Payment Management for Magento 2 19

23 Security Credentials

In addition to the Secure Acceptance security credentials created in Section 21 the module usesother connection methods to access CyberSource services that require their own security credentialsfor authentication

Note Configuring of SOAP Toolkit Key is mandatory for this extension proper functioning

231 Create a SOAP Toolkit Key

The CyberSource Module for Magento makes use of the SOAP Toolkit API to access several Cyber-Source services that do not include the transmission of card data

To create a SOAP Toolkit API transaction key navigate in the Enterprise Business Center to PaymentConfiguration gt Key Management

1 Click the ldquoGenerate Keyrdquo button

2 Select the ldquoTransaction processingrdquo key type and click ldquoNext Steprdquo

3 Select the ldquoSOAPrdquo as key subtype and click ldquoSubmitrdquo

4 Save the resulting key for purposes of entering in your Magento configuration

Figure 211 Create a Transaction Security Key - Selecting Key Type

Oct 07 2019 CyberSource Global Payment Management for Magento 2 20

Figure 212 Create a Transaction Security Key - Selecting Key Subtype

Figure 213 Create a Transaction Security Key - Generated SOAP Toolkit Key

Oct 07 2019 CyberSource Global Payment Management for Magento 2 21

232 Create a Report Download User

The CyberSourceModule for Magento uses a reporting API that allowsMagento to query CyberSourcefor information about transactions To activate this you must create a separate CyberSource BusinessCenter user with the role of ldquoReport Downloadrdquo

Figure 214 CyberSource Business Center Main Navigation - User Administration

Navigate to the Account Management gt User Administration section of the main navigation Thescreen will show a listing of active users Click the ldquoAdd Userrdquo button The next screen will look likethis

Oct 07 2019 CyberSource Global Payment Management for Magento 2 22

Figure 215 Add New CyberSource Business Center User Screen

Fill out the form and select lsquoReport Downloadrsquo User Role Once you complete the Add User form anemail will be sent to the address used on the form The email will contain a link and a onetime lsquotokenrsquoused to validate the email account Once the token is entered you will be asked to reset the passwordThis password is needed in Section 31 for the lsquoReport Passwordrsquo

Oct 07 2019 CyberSource Global Payment Management for Magento 2 23

24 Backend Setup

Certain CyberSource services supported by the Module require additional backend setup on yourMerchant ID Please contact your CyberSource Account Representative to enable any of the followingservices

1 Payment Tokenization Required by the Module for Credit Card processing

2 Decision Manager

3 Payer Authentication

4 PayPal Express Checkout New credentials are required for Alt Pay connection Additional setupin PayPal is documented in the PayPal guide listed in Section 6 of this document

5 eChecks

6 Online Bank Transfers

7 Tax Calculation

8 Klarna

9 Account Takeover Protection

10 Account Updater

11 Visa Checkout (enabled in the EBC)

12 Apple Pay (enabled in the EBC)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 24

3 Magento Backend Configuration Settings

Once logged into the administration section of your Magento 2 website the configuration panel isfound by navigating to the following screen

Stores gt Configuration gt Sales gt Payment Methods

Once on that screen you will see the settings for the CyberSource module Inside this panel areadditional sub panels

25

Figure 31 Main CyberSource configuration panel with sub panels

Oct 07 2019 CyberSource Global Payment Management for Magento 2 26

31 General Settings

Figure 32 General Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 27

Figure 33 General Settings (continued)

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of Secure Acceptance

payment method for credit cards This is used for both Web Mobileand Silent Order Post configurations

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 28

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 21: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

22 Decision Manager

For the purposes of configuring Magento to work with Decision Manager the following sections out-line some brief topics that help describe how Magento and Decision Manger will work together

221 Orders

When enabled Decision Manager runs in real time with the Authorization The possible decisions areACCEPT REJECT REVIEW or ERROR Orders set to REVIEW by Decision Manager will be marked asPending Review in Magento

When you change an order in Decision Manager Case Management from REVIEW to REJECT or AC-CEPT Magento will not immediately learn of this change Magento will learn of any changes to pay-ment transaction states periodically (by cron every 2 minutes) by contacting CyberSource and query-ing for changes Section 36 describes how you configure Magento Cron settings that will trigger aMagento task that will look for Decision Manager changes and update Magento Orders accordingly

If a change in state is detected the module will update the order status in Magento from PendingReview to one of these states Processing Pending Payment or Closed

Please note that if an order is Pending Review in Decision Manager you cannot prepare an invoice inMagento until it is accepted in Decision Manager

222 Refunds

Please note the order must be either Accepted or Rejected in Decision Manager before you are ableto issue a refund Rejecting an order in Decision Manager will automatically perform an AuthorizationReversal for the order as part of the Cron process that queries CyberSource for updates in DecisionManager

223 Custom Fields

Decision Manager supports up to 100 custom fields called Merchant Defined Data Fields The Cy-berSource Module for Magento 2 will send ten of these fields but they must be configured insideDecision Manager in order to make use of them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 18

Figure 210 CyberSource Business Center Decision Manager Custom Fields Configuration

To add the additional custom fields provided by Magento 2 login to the Business Center and navigateto Decision Manager gt Shared Configuration gt Custom Fields Use the tables below to configure thefields

To add a field click the Add Custom Field button select the Order Element and input the name Followthe table below to map the correct element and name

Field Name Order ElementLogged in customer merchant_defined_data1Account creation date merchant_defined_data2Purchase History Count merchant_defined_data3Last Order Date merchant_defined_data4Member account age merchant_defined_data5Repeat customer merchant_defined_data6Coupon Code Used merchant_defined_data20Discount Amount merchant_defined_data21Gift Message merchant_defined_data22Order Source merchant_defined_data23Shipping Method Code merchant_defined_data31Shipping Method Description merchant_defined_data32

For complete Decision Manager configuration instructions please refer to the CyberSource DecisionManager User Guide referenced in Section 6 of this manual

Oct 07 2019 CyberSource Global Payment Management for Magento 2 19

23 Security Credentials

In addition to the Secure Acceptance security credentials created in Section 21 the module usesother connection methods to access CyberSource services that require their own security credentialsfor authentication

Note Configuring of SOAP Toolkit Key is mandatory for this extension proper functioning

231 Create a SOAP Toolkit Key

The CyberSource Module for Magento makes use of the SOAP Toolkit API to access several Cyber-Source services that do not include the transmission of card data

To create a SOAP Toolkit API transaction key navigate in the Enterprise Business Center to PaymentConfiguration gt Key Management

1 Click the ldquoGenerate Keyrdquo button

2 Select the ldquoTransaction processingrdquo key type and click ldquoNext Steprdquo

3 Select the ldquoSOAPrdquo as key subtype and click ldquoSubmitrdquo

4 Save the resulting key for purposes of entering in your Magento configuration

Figure 211 Create a Transaction Security Key - Selecting Key Type

Oct 07 2019 CyberSource Global Payment Management for Magento 2 20

Figure 212 Create a Transaction Security Key - Selecting Key Subtype

Figure 213 Create a Transaction Security Key - Generated SOAP Toolkit Key

Oct 07 2019 CyberSource Global Payment Management for Magento 2 21

232 Create a Report Download User

The CyberSourceModule for Magento uses a reporting API that allowsMagento to query CyberSourcefor information about transactions To activate this you must create a separate CyberSource BusinessCenter user with the role of ldquoReport Downloadrdquo

Figure 214 CyberSource Business Center Main Navigation - User Administration

Navigate to the Account Management gt User Administration section of the main navigation Thescreen will show a listing of active users Click the ldquoAdd Userrdquo button The next screen will look likethis

Oct 07 2019 CyberSource Global Payment Management for Magento 2 22

Figure 215 Add New CyberSource Business Center User Screen

Fill out the form and select lsquoReport Downloadrsquo User Role Once you complete the Add User form anemail will be sent to the address used on the form The email will contain a link and a onetime lsquotokenrsquoused to validate the email account Once the token is entered you will be asked to reset the passwordThis password is needed in Section 31 for the lsquoReport Passwordrsquo

Oct 07 2019 CyberSource Global Payment Management for Magento 2 23

24 Backend Setup

Certain CyberSource services supported by the Module require additional backend setup on yourMerchant ID Please contact your CyberSource Account Representative to enable any of the followingservices

1 Payment Tokenization Required by the Module for Credit Card processing

2 Decision Manager

3 Payer Authentication

4 PayPal Express Checkout New credentials are required for Alt Pay connection Additional setupin PayPal is documented in the PayPal guide listed in Section 6 of this document

5 eChecks

6 Online Bank Transfers

7 Tax Calculation

8 Klarna

9 Account Takeover Protection

10 Account Updater

11 Visa Checkout (enabled in the EBC)

12 Apple Pay (enabled in the EBC)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 24

3 Magento Backend Configuration Settings

Once logged into the administration section of your Magento 2 website the configuration panel isfound by navigating to the following screen

Stores gt Configuration gt Sales gt Payment Methods

Once on that screen you will see the settings for the CyberSource module Inside this panel areadditional sub panels

25

Figure 31 Main CyberSource configuration panel with sub panels

Oct 07 2019 CyberSource Global Payment Management for Magento 2 26

31 General Settings

Figure 32 General Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 27

Figure 33 General Settings (continued)

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of Secure Acceptance

payment method for credit cards This is used for both Web Mobileand Silent Order Post configurations

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 28

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 22: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Figure 210 CyberSource Business Center Decision Manager Custom Fields Configuration

To add the additional custom fields provided by Magento 2 login to the Business Center and navigateto Decision Manager gt Shared Configuration gt Custom Fields Use the tables below to configure thefields

To add a field click the Add Custom Field button select the Order Element and input the name Followthe table below to map the correct element and name

Field Name Order ElementLogged in customer merchant_defined_data1Account creation date merchant_defined_data2Purchase History Count merchant_defined_data3Last Order Date merchant_defined_data4Member account age merchant_defined_data5Repeat customer merchant_defined_data6Coupon Code Used merchant_defined_data20Discount Amount merchant_defined_data21Gift Message merchant_defined_data22Order Source merchant_defined_data23Shipping Method Code merchant_defined_data31Shipping Method Description merchant_defined_data32

For complete Decision Manager configuration instructions please refer to the CyberSource DecisionManager User Guide referenced in Section 6 of this manual

Oct 07 2019 CyberSource Global Payment Management for Magento 2 19

23 Security Credentials

In addition to the Secure Acceptance security credentials created in Section 21 the module usesother connection methods to access CyberSource services that require their own security credentialsfor authentication

Note Configuring of SOAP Toolkit Key is mandatory for this extension proper functioning

231 Create a SOAP Toolkit Key

The CyberSource Module for Magento makes use of the SOAP Toolkit API to access several Cyber-Source services that do not include the transmission of card data

To create a SOAP Toolkit API transaction key navigate in the Enterprise Business Center to PaymentConfiguration gt Key Management

1 Click the ldquoGenerate Keyrdquo button

2 Select the ldquoTransaction processingrdquo key type and click ldquoNext Steprdquo

3 Select the ldquoSOAPrdquo as key subtype and click ldquoSubmitrdquo

4 Save the resulting key for purposes of entering in your Magento configuration

Figure 211 Create a Transaction Security Key - Selecting Key Type

Oct 07 2019 CyberSource Global Payment Management for Magento 2 20

Figure 212 Create a Transaction Security Key - Selecting Key Subtype

Figure 213 Create a Transaction Security Key - Generated SOAP Toolkit Key

Oct 07 2019 CyberSource Global Payment Management for Magento 2 21

232 Create a Report Download User

The CyberSourceModule for Magento uses a reporting API that allowsMagento to query CyberSourcefor information about transactions To activate this you must create a separate CyberSource BusinessCenter user with the role of ldquoReport Downloadrdquo

Figure 214 CyberSource Business Center Main Navigation - User Administration

Navigate to the Account Management gt User Administration section of the main navigation Thescreen will show a listing of active users Click the ldquoAdd Userrdquo button The next screen will look likethis

Oct 07 2019 CyberSource Global Payment Management for Magento 2 22

Figure 215 Add New CyberSource Business Center User Screen

Fill out the form and select lsquoReport Downloadrsquo User Role Once you complete the Add User form anemail will be sent to the address used on the form The email will contain a link and a onetime lsquotokenrsquoused to validate the email account Once the token is entered you will be asked to reset the passwordThis password is needed in Section 31 for the lsquoReport Passwordrsquo

Oct 07 2019 CyberSource Global Payment Management for Magento 2 23

24 Backend Setup

Certain CyberSource services supported by the Module require additional backend setup on yourMerchant ID Please contact your CyberSource Account Representative to enable any of the followingservices

1 Payment Tokenization Required by the Module for Credit Card processing

2 Decision Manager

3 Payer Authentication

4 PayPal Express Checkout New credentials are required for Alt Pay connection Additional setupin PayPal is documented in the PayPal guide listed in Section 6 of this document

5 eChecks

6 Online Bank Transfers

7 Tax Calculation

8 Klarna

9 Account Takeover Protection

10 Account Updater

11 Visa Checkout (enabled in the EBC)

12 Apple Pay (enabled in the EBC)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 24

3 Magento Backend Configuration Settings

Once logged into the administration section of your Magento 2 website the configuration panel isfound by navigating to the following screen

Stores gt Configuration gt Sales gt Payment Methods

Once on that screen you will see the settings for the CyberSource module Inside this panel areadditional sub panels

25

Figure 31 Main CyberSource configuration panel with sub panels

Oct 07 2019 CyberSource Global Payment Management for Magento 2 26

31 General Settings

Figure 32 General Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 27

Figure 33 General Settings (continued)

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of Secure Acceptance

payment method for credit cards This is used for both Web Mobileand Silent Order Post configurations

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 28

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 23: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

23 Security Credentials

In addition to the Secure Acceptance security credentials created in Section 21 the module usesother connection methods to access CyberSource services that require their own security credentialsfor authentication

Note Configuring of SOAP Toolkit Key is mandatory for this extension proper functioning

231 Create a SOAP Toolkit Key

The CyberSource Module for Magento makes use of the SOAP Toolkit API to access several Cyber-Source services that do not include the transmission of card data

To create a SOAP Toolkit API transaction key navigate in the Enterprise Business Center to PaymentConfiguration gt Key Management

1 Click the ldquoGenerate Keyrdquo button

2 Select the ldquoTransaction processingrdquo key type and click ldquoNext Steprdquo

3 Select the ldquoSOAPrdquo as key subtype and click ldquoSubmitrdquo

4 Save the resulting key for purposes of entering in your Magento configuration

Figure 211 Create a Transaction Security Key - Selecting Key Type

Oct 07 2019 CyberSource Global Payment Management for Magento 2 20

Figure 212 Create a Transaction Security Key - Selecting Key Subtype

Figure 213 Create a Transaction Security Key - Generated SOAP Toolkit Key

Oct 07 2019 CyberSource Global Payment Management for Magento 2 21

232 Create a Report Download User

The CyberSourceModule for Magento uses a reporting API that allowsMagento to query CyberSourcefor information about transactions To activate this you must create a separate CyberSource BusinessCenter user with the role of ldquoReport Downloadrdquo

Figure 214 CyberSource Business Center Main Navigation - User Administration

Navigate to the Account Management gt User Administration section of the main navigation Thescreen will show a listing of active users Click the ldquoAdd Userrdquo button The next screen will look likethis

Oct 07 2019 CyberSource Global Payment Management for Magento 2 22

Figure 215 Add New CyberSource Business Center User Screen

Fill out the form and select lsquoReport Downloadrsquo User Role Once you complete the Add User form anemail will be sent to the address used on the form The email will contain a link and a onetime lsquotokenrsquoused to validate the email account Once the token is entered you will be asked to reset the passwordThis password is needed in Section 31 for the lsquoReport Passwordrsquo

Oct 07 2019 CyberSource Global Payment Management for Magento 2 23

24 Backend Setup

Certain CyberSource services supported by the Module require additional backend setup on yourMerchant ID Please contact your CyberSource Account Representative to enable any of the followingservices

1 Payment Tokenization Required by the Module for Credit Card processing

2 Decision Manager

3 Payer Authentication

4 PayPal Express Checkout New credentials are required for Alt Pay connection Additional setupin PayPal is documented in the PayPal guide listed in Section 6 of this document

5 eChecks

6 Online Bank Transfers

7 Tax Calculation

8 Klarna

9 Account Takeover Protection

10 Account Updater

11 Visa Checkout (enabled in the EBC)

12 Apple Pay (enabled in the EBC)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 24

3 Magento Backend Configuration Settings

Once logged into the administration section of your Magento 2 website the configuration panel isfound by navigating to the following screen

Stores gt Configuration gt Sales gt Payment Methods

Once on that screen you will see the settings for the CyberSource module Inside this panel areadditional sub panels

25

Figure 31 Main CyberSource configuration panel with sub panels

Oct 07 2019 CyberSource Global Payment Management for Magento 2 26

31 General Settings

Figure 32 General Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 27

Figure 33 General Settings (continued)

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of Secure Acceptance

payment method for credit cards This is used for both Web Mobileand Silent Order Post configurations

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 28

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 24: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Figure 212 Create a Transaction Security Key - Selecting Key Subtype

Figure 213 Create a Transaction Security Key - Generated SOAP Toolkit Key

Oct 07 2019 CyberSource Global Payment Management for Magento 2 21

232 Create a Report Download User

The CyberSourceModule for Magento uses a reporting API that allowsMagento to query CyberSourcefor information about transactions To activate this you must create a separate CyberSource BusinessCenter user with the role of ldquoReport Downloadrdquo

Figure 214 CyberSource Business Center Main Navigation - User Administration

Navigate to the Account Management gt User Administration section of the main navigation Thescreen will show a listing of active users Click the ldquoAdd Userrdquo button The next screen will look likethis

Oct 07 2019 CyberSource Global Payment Management for Magento 2 22

Figure 215 Add New CyberSource Business Center User Screen

Fill out the form and select lsquoReport Downloadrsquo User Role Once you complete the Add User form anemail will be sent to the address used on the form The email will contain a link and a onetime lsquotokenrsquoused to validate the email account Once the token is entered you will be asked to reset the passwordThis password is needed in Section 31 for the lsquoReport Passwordrsquo

Oct 07 2019 CyberSource Global Payment Management for Magento 2 23

24 Backend Setup

Certain CyberSource services supported by the Module require additional backend setup on yourMerchant ID Please contact your CyberSource Account Representative to enable any of the followingservices

1 Payment Tokenization Required by the Module for Credit Card processing

2 Decision Manager

3 Payer Authentication

4 PayPal Express Checkout New credentials are required for Alt Pay connection Additional setupin PayPal is documented in the PayPal guide listed in Section 6 of this document

5 eChecks

6 Online Bank Transfers

7 Tax Calculation

8 Klarna

9 Account Takeover Protection

10 Account Updater

11 Visa Checkout (enabled in the EBC)

12 Apple Pay (enabled in the EBC)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 24

3 Magento Backend Configuration Settings

Once logged into the administration section of your Magento 2 website the configuration panel isfound by navigating to the following screen

Stores gt Configuration gt Sales gt Payment Methods

Once on that screen you will see the settings for the CyberSource module Inside this panel areadditional sub panels

25

Figure 31 Main CyberSource configuration panel with sub panels

Oct 07 2019 CyberSource Global Payment Management for Magento 2 26

31 General Settings

Figure 32 General Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 27

Figure 33 General Settings (continued)

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of Secure Acceptance

payment method for credit cards This is used for both Web Mobileand Silent Order Post configurations

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 28

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 25: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

232 Create a Report Download User

The CyberSourceModule for Magento uses a reporting API that allowsMagento to query CyberSourcefor information about transactions To activate this you must create a separate CyberSource BusinessCenter user with the role of ldquoReport Downloadrdquo

Figure 214 CyberSource Business Center Main Navigation - User Administration

Navigate to the Account Management gt User Administration section of the main navigation Thescreen will show a listing of active users Click the ldquoAdd Userrdquo button The next screen will look likethis

Oct 07 2019 CyberSource Global Payment Management for Magento 2 22

Figure 215 Add New CyberSource Business Center User Screen

Fill out the form and select lsquoReport Downloadrsquo User Role Once you complete the Add User form anemail will be sent to the address used on the form The email will contain a link and a onetime lsquotokenrsquoused to validate the email account Once the token is entered you will be asked to reset the passwordThis password is needed in Section 31 for the lsquoReport Passwordrsquo

Oct 07 2019 CyberSource Global Payment Management for Magento 2 23

24 Backend Setup

Certain CyberSource services supported by the Module require additional backend setup on yourMerchant ID Please contact your CyberSource Account Representative to enable any of the followingservices

1 Payment Tokenization Required by the Module for Credit Card processing

2 Decision Manager

3 Payer Authentication

4 PayPal Express Checkout New credentials are required for Alt Pay connection Additional setupin PayPal is documented in the PayPal guide listed in Section 6 of this document

5 eChecks

6 Online Bank Transfers

7 Tax Calculation

8 Klarna

9 Account Takeover Protection

10 Account Updater

11 Visa Checkout (enabled in the EBC)

12 Apple Pay (enabled in the EBC)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 24

3 Magento Backend Configuration Settings

Once logged into the administration section of your Magento 2 website the configuration panel isfound by navigating to the following screen

Stores gt Configuration gt Sales gt Payment Methods

Once on that screen you will see the settings for the CyberSource module Inside this panel areadditional sub panels

25

Figure 31 Main CyberSource configuration panel with sub panels

Oct 07 2019 CyberSource Global Payment Management for Magento 2 26

31 General Settings

Figure 32 General Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 27

Figure 33 General Settings (continued)

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of Secure Acceptance

payment method for credit cards This is used for both Web Mobileand Silent Order Post configurations

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 28

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 26: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Figure 215 Add New CyberSource Business Center User Screen

Fill out the form and select lsquoReport Downloadrsquo User Role Once you complete the Add User form anemail will be sent to the address used on the form The email will contain a link and a onetime lsquotokenrsquoused to validate the email account Once the token is entered you will be asked to reset the passwordThis password is needed in Section 31 for the lsquoReport Passwordrsquo

Oct 07 2019 CyberSource Global Payment Management for Magento 2 23

24 Backend Setup

Certain CyberSource services supported by the Module require additional backend setup on yourMerchant ID Please contact your CyberSource Account Representative to enable any of the followingservices

1 Payment Tokenization Required by the Module for Credit Card processing

2 Decision Manager

3 Payer Authentication

4 PayPal Express Checkout New credentials are required for Alt Pay connection Additional setupin PayPal is documented in the PayPal guide listed in Section 6 of this document

5 eChecks

6 Online Bank Transfers

7 Tax Calculation

8 Klarna

9 Account Takeover Protection

10 Account Updater

11 Visa Checkout (enabled in the EBC)

12 Apple Pay (enabled in the EBC)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 24

3 Magento Backend Configuration Settings

Once logged into the administration section of your Magento 2 website the configuration panel isfound by navigating to the following screen

Stores gt Configuration gt Sales gt Payment Methods

Once on that screen you will see the settings for the CyberSource module Inside this panel areadditional sub panels

25

Figure 31 Main CyberSource configuration panel with sub panels

Oct 07 2019 CyberSource Global Payment Management for Magento 2 26

31 General Settings

Figure 32 General Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 27

Figure 33 General Settings (continued)

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of Secure Acceptance

payment method for credit cards This is used for both Web Mobileand Silent Order Post configurations

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 28

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 27: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

24 Backend Setup

Certain CyberSource services supported by the Module require additional backend setup on yourMerchant ID Please contact your CyberSource Account Representative to enable any of the followingservices

1 Payment Tokenization Required by the Module for Credit Card processing

2 Decision Manager

3 Payer Authentication

4 PayPal Express Checkout New credentials are required for Alt Pay connection Additional setupin PayPal is documented in the PayPal guide listed in Section 6 of this document

5 eChecks

6 Online Bank Transfers

7 Tax Calculation

8 Klarna

9 Account Takeover Protection

10 Account Updater

11 Visa Checkout (enabled in the EBC)

12 Apple Pay (enabled in the EBC)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 24

3 Magento Backend Configuration Settings

Once logged into the administration section of your Magento 2 website the configuration panel isfound by navigating to the following screen

Stores gt Configuration gt Sales gt Payment Methods

Once on that screen you will see the settings for the CyberSource module Inside this panel areadditional sub panels

25

Figure 31 Main CyberSource configuration panel with sub panels

Oct 07 2019 CyberSource Global Payment Management for Magento 2 26

31 General Settings

Figure 32 General Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 27

Figure 33 General Settings (continued)

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of Secure Acceptance

payment method for credit cards This is used for both Web Mobileand Silent Order Post configurations

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 28

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 28: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

3 Magento Backend Configuration Settings

Once logged into the administration section of your Magento 2 website the configuration panel isfound by navigating to the following screen

Stores gt Configuration gt Sales gt Payment Methods

Once on that screen you will see the settings for the CyberSource module Inside this panel areadditional sub panels

25

Figure 31 Main CyberSource configuration panel with sub panels

Oct 07 2019 CyberSource Global Payment Management for Magento 2 26

31 General Settings

Figure 32 General Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 27

Figure 33 General Settings (continued)

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of Secure Acceptance

payment method for credit cards This is used for both Web Mobileand Silent Order Post configurations

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 28

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 29: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Figure 31 Main CyberSource configuration panel with sub panels

Oct 07 2019 CyberSource Global Payment Management for Magento 2 26

31 General Settings

Figure 32 General Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 27

Figure 33 General Settings (continued)

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of Secure Acceptance

payment method for credit cards This is used for both Web Mobileand Silent Order Post configurations

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 28

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 30: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

31 General Settings

Figure 32 General Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 27

Figure 33 General Settings (continued)

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of Secure Acceptance

payment method for credit cards This is used for both Web Mobileand Silent Order Post configurations

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 28

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 31: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Figure 33 General Settings (continued)

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of Secure Acceptance

payment method for credit cards This is used for both Web Mobileand Silent Order Post configurations

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 28

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 32: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Table 31 ndash continued from previous pageSetting NotesDM fail email sender If the order is rejected by Decision Manager the customer will be

notified Select the admin sender contact hereDM fail email template If the order is rejected by Decision Manager the customer will be

notified Select the email template to be used hereSecure Acceptance Type CyberSource Secure Acceptance WebMobile lets you securely ac-

cept payments made on the web or on mobile browsers worldwidewithout handling payment data (process involves a redirect to Cyber-Source) The Silent Order POST integration method securely passesor ldquopostsrdquo payment data from the customer directly to the Cyber-Source system (the process does not involve a redirect to Cyber-Source)

Credit Card Types Select which card types you would like to accept This only appliesto Silent Order Post configuration It is not used for WebMobile

Payment Action for SecureAcceptance

Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Report Server URL Test httpsebctestcybersourcecomebctestProduction httpsebccybersourcecomebc

Service URL httpssecureacceptancecybersourcecomService URL for tests httpstestsecureacceptancecybersourcecomPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesis used to determine if the customers billing Country is applicable foruse of this payment method If set to lsquoSpecific Countriesrsquo the nextsetting is used to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable DM CRON If Decision Manager (DM) is used by your configuration Magentomust learn of any changes to DM status Enable this setting to en-sure Magento will query CyberSource to check on the status of anytransactions that were set to lsquoREVIEWrsquo to see if any have been eitheraccepted or rejected Disable this setting if Decision Manager is notused

Test Mode If yes CyberSource Test environments are used when processingtransactions If no all transactions use production environments

Debug Mode If Yes diagnostic information is stored in log files on the Magentoweb server If No no information is logged

Ignore AVS If set yes the results of AVS verification are ignored See CyberSourceSecure Acceptance pdf page 74 for additional information

Authorize via Secure Accep-tance

If set to No the card information is tokenized via CyberSource autho-rization is requested separately via SOAP service (Recommended)If set Yes an authorization is performed at the moment of postingcard data to CyberSource (Compatible with 30x extension)

Ignore CVN If set yes the results of CVN verification are ignored See Cyber-Source Secure Acceptance

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 29

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 33: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Table 31 ndash continued from previous pageSetting NotesSort Order Change the default module sort order hereDeveloper ID This is an optional field that must be no longer than 8 characters De-

veloper IDrsquos are assigned by CyberSource by request Please contactyour CyberSource Alliance Manager to have one assigned to you

Report Password See Section 232Report Username See Section 232Report URL Testing httpsebctestcybersourcecomebctest

ConversionDetailReportRequestdo Production httpsebccybersourcecomebcConversionDetailReportRequestdo

Auth Indicator See page 126 of CyberSource Credit Card Services pdfShow exact rejection or er-ror message to users

If set to No the general error message will be displayed in all rejectionand error cases

Oct 07 2019 CyberSource Global Payment Management for Magento 2 30

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 34: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

32 SOAP Web Services Settings

Figure 34 SOAP API Web Service Settings

Setting NotesMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Use Test WSDL Select ldquoYesrdquo if Test Business Center is used and ldquoNordquo for production

usePath to WSDL httpsics2wsaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdlPath to test WSDL httpsics2wstestaic3comcommerce1xtransactionProcessor

CyberSourceTransaction_1158wsdl

NOTE SOAP Web Service section proper configuration is required for other services including TaxCalculation Secure Acceptance Visa Checkout PayPal Account Takeover Protection and Apple PayIf you experience issues with these modules please make sure the SOAP Web Service options areconfigured properly ldquoMerchant IDrdquo and ldquoTransaction Keyrdquo have correct value and ldquoUse Test WSDLrdquooption matches your CyberSource Merchant account environment

Oct 07 2019 CyberSource Global Payment Management for Magento 2 31

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 35: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

33 E-Check

The CyberSource E-Check module allows customers to make purchases using a Routing Number andan Account Number

331 Payment Event Types

During checkout an E-Check transaction request is sent to CyberSource and if successful the transac-tion is sent to the Automated Clearing House (ACH) This process mirrors how physical Checks work

Magento will Query CyberSource periodically to check on the status of each Pending E-Check trans-action In response CyberSource will provide updated Transaction Statuses called a lsquoPayment EventTypersquo As a result there are many possible outcomes that can happen during ACH processing Foreach Pending Transaction included in the CyberSource response Magentomust decide if a transactionshould remain Pending or if it should be considered Settled or if the transaction was Rejected

To manage this the settings below allow you to configure what action Magento will take for eachPayment Event Type

If the Payment Event Type is mapped as a Pending Event Type no change is made to the Transactionor Order status The order should remain in Payment Pending state

If the payment Event Type is mapped as a Reject Event Type the order is cancelled

If the payment Event Type is mapped as an Accept Event Type an invoice is prepared for that orderand the order status will change to Processing

For a description of possible Payment Event Types see page 86 of this Reporting Developer Guide inSection 6

332 Testing

Testing E-Check Payment Event Types is difficult because a sandbox environment is not available tosimulate each Event Type As a result there are two settings in Magento that will help simulate thepossible event types during processing of the requested report

To use this system toggle the lsquoUse Test Environmentrsquo setting and select a Test Payment Event Typeto simulate Once configured the status request is made to CyberSource for each pending E-Checktransaction but Magento will ignore the returned Payment Event Type in the response and insteaduse the Test Event Type

Note Ensure this feature is disabled for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 32

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 36: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Figure 35 CyberSource E-Check Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 33

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 37: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Figure 36 CyberSource E-Check Settings (continued)

Setting NotesEnabled This setting activates or deactivates this payment methodTitle This text is displayed to customers as the name of this payment

methodPending Event Type Select which payment statuses that you will consider lsquoPendingrsquo This

would signify transactions for which no deposit has been receivedyetContact your CyberSource representative if you have any questionsabout appropriate statuses

Continued on next page

Oct 07 2019 CyberSource Global Payment Management for Magento 2 34

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 38: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Table 32 ndash continued from previous pageSetting NotesReject Event Type Transactions that were initially accepted during checkout but after

processing by the Automated Clear House the transaction was re-jected Magento will learn of transactions that have failed

Accept Event Type Select Event Types that signify the receipt of funds so an invoice canbe prepared and the order status moved to lsquoProcessingrsquo

Test Event Type When Testing you can use this setting to simulate a Payment EventType for all lsquoPending Paymentrsquo orders that were paid for with an E-Check transaction

Use test environment If enabled Magento will replace the Payment Event Type returned byCyberSource with the Event Type configured in the lsquoTest Event Typersquosetting

Test Service URL httpsebctestcybersourcecomebctestQueryService URL httpsebccybersourcecomebcQueryMerchant Username CyberSource Business Center Username with Report Download per-

missionsMerchant password Password for Report Download userPayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento 2 global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Report check period days The report is generated daily Monday through Friday unless Cyber-Source does not receive a data file from the processor receives thedata file after the cut-off time or receives an empty data file Becausethe report is not generated on weekends the report that you down-load on Mondays contains all your weekend transactions Make sureyour implementation can handle reports that contain transactionsspanning multiple processing days

Sort Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 35

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 39: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

34 Secure Acceptance WebMobile

Figure 37 Secure Acceptance Web Mobile Settings

Setting NotesSecret Key See Section 214Profile ID See Section 212Access Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above go using primary profile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 36

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 40: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

35 Token Management Service

Figure 38 Tokenization service settings

Setting NotesTokenization Enabled Enables the customer to save their credit card information securely

for later useTokenization Title Specify the title of stored token payment method (visible in admin

orders payment method list)Use CVV for Saved CreditCards

If set to Yes the customer will be asked to enter Card Security Codewhen paying with stored cards

Use CVV for Saved CreditCards in Admin

If set to Yes merchant will be asked to enter customerrsquos Card SecurityCode when paying with stored cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 37

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 41: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

36 3D Secure 20

The 3D Secure protocol often known by its branded names like ldquoVerified by Visardquo or ldquoMastercardSecureCoderdquo aims to reduce fraud and provide added security to online payments 3D Secure v2 addsldquofrictionless authenticationrdquo and improves the user experience

Figure 39 CyberSource 3D 20 Secure Settings

Setting NotesEnabled This setting activates or deactivates the moduleTest Mode Select between Production or Sandbox modesOrg Unit ID Please contact CyberSource to obtain this valueAPI ID Please contact CyberSource to obtain this valueAPI Key Please contact CyberSource to obtain this value

Oct 07 2019 CyberSource Global Payment Management for Magento 2 38

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 42: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

37 Delivery Address Verification Service

Figure 310 CyberSource Shipping Address Verification Settings

Setting NotesAddress verification This setting activates or deactivates the moduleAddress force normaliza-tion

Addresses processed by this system may return a suggested alter-native address that will reduce misrouting of shipments This settingwill make suggested alternatives optional or mandatory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 39

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 43: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

38 Klarna

Figure 311 Klarna configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 40

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 44: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode Select between Production or Sandbox modesNew order status This will display the status of the new order whether Process-

ingSuspected fraudPayment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Sort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesare used to determine if the customerrsquos billing Country is allowed forthis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi select box allowing the store owner to specify countriesthat will be allowed to use this payment method

Oct 07 2019 CyberSource Global Payment Management for Magento 2 41

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 45: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

39 Secure Acceptance Silent Order Post (SOP)

Figure 312 CyberSource SOP Settings

Setting NotesProfile ID See Section 212Access Key See Section 214Secret Key See Section 214Use another profile forpayer authentication pay-ments

If enabled the additional Profile may be configured for frontendcheckout use and additional group of Profile options is visible Ad-min orders and stored credit card payment will still go using primaryprofile configured above

Secret Key (additional) For additional profileProfile ID (additional) For additional profileAccess Key (additional) For additional profile

Oct 07 2019 CyberSource Global Payment Management for Magento 2 42

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 46: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

310 PayPal Express Checkout

Figure 313 PayPal Express Checkout Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 43

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 47: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedPayPal Redirection Type Traditional Express Checkout Customer will be redirect to PayPal

Payment Page In-Context Express Checkout A PayPal popup willappear to customer complete payment

Payment Action Authorize Only will check the account for validity but not charge theit until the order is approved and invoiced Authorize and Capturewill charge the PayPal account at the time of the order submission

Payment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Payment from SpecificCountries

This is a multi-select box allowing the store owner to specify coun-tries that will be allowed to use this payment method

Enable PayPal Credit This setting activates or deactivates the modulePayPal Credit Title This text is displayed to customers as the title of PayPal Credit pay-

ment optionEnable PayPal Billing Agree-ments

Allows the registered customers to create a billing agreement forfaster purchases in future

Sort Order A numeric value used to arrange this payment method amongst allthe other CyberSource payment methods

Oct 07 2019 CyberSource Global Payment Management for Magento 2 44

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 48: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

311 Device Fingerprint

Figure 314 CyberSource Device Fingerprint Settings

Device Fingerprinting is used with Decision Manager for all relevant payment methods If you are notusing Decision Manager you should disable this module

Setting NotesActive This setting activates or deactivates Device FingerprintingOrg ID Obtain the Org ID from CyberSource and enter it here There is an

Org ID for the Test environment and another one for Production

Oct 07 2019 CyberSource Global Payment Management for Magento 2 45

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 49: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

312 Bank Transfer

Figure 315 CyberSource Bank Transfer Settings

Online banking services enable customers to pay for goods using direct online bank transfers fromtheir bank account to your merchant account

Oct 07 2019 CyberSource Global Payment Management for Magento 2 46

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 50: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

3121 iDEAL

Figure 316 CyberSource iDeal Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 47

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 51: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this method should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 48

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 52: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

3122 Sofort

Figure 317 CyberSource Sofort Settings

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 49

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 53: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

3123 Bancontact

Figure 318 CyberSource Bancontact settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 50

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 54: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 51

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 55: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

3124 EPS

Figure 319 CyberSource EPS Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 52

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 56: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default module sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 53

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 57: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

3125 giropay

Figure 320 CyberSource giropay configuration

Oct 07 2019 CyberSource Global Payment Management for Magento 2 54

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 58: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Setting NotesEnabled This setting activates or deactivates the methodTitle This text is displayed to customers as the name of this particular pay-

ment methodMerchant ID Your CyberSource Merchant IDTransaction Key See Section 231Allowed Currencies Select which currencies this module should be active forSort Order Change the default payment method sort order herePayment from ApplicableCountries

If set to lsquoAll Allowedrsquo Magento global settings for allowed countriesis used to determine if the customers billing Country is allowed to usethis payment method If set to lsquoSpecific Countriesrsquo the next setting isused to configure allowed countries for this module

Specific Countries If lsquoPayment from Applicable Countriesrsquo options is set to lsquoSpecificCountriesrsquo this allows to select them

Oct 07 2019 CyberSource Global Payment Management for Magento 2 55

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 59: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

313 Visa Checkout

Figure 321 Visa Checkout configuration

Setting NotesEnabled This setting activates or deactivates the moduleTitle This text is displayed to customers as the name of this payment

methodTest Mode If yes the CyberSource Test credentials are used If no Production

credentials are usedAPI Key Enter your Visa Checkout API Key here Could be obtained from Cy-

berSource EBC in the menu Account Management gt Digital PaymentSolutions gt Visa checkout gt Settings tab gt Visa Checkout API keyfield

Payment Action Set to Authorize Only to reserve funds during checkout and captureduring invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Soft Order Change the default module sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 56

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 60: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

314 Apple Pay

In order to use Apple Pay there are few assumptions and prerequisites which one should take intoconsideration

bull You must have an Apple Developer Account

bull All pages that incorporate Apple Pay must be served over HTTPS

bull Your website must comply with the Apple Pay guidelines For more information see Apple Payon the Web Acceptable Use Guidelines

bull Your website must have HTTPS mode enabled and used on checkout httpsdeveloperapplecomdocumentationapplepayjssetting_up_server_requirements

In order to configure Apple Pay with CyberSource Magento module your must perform several ac-tions

1 Register an Apple Pay Merchant ID

2 Validate your Store domain in Apple Pay

3 Create a Payment Processing certificate

4 Create a Merchant Identity certificate

3141 Creating a Merchant ID

See official Applersquos article

1 Go to Certificates Identifiers amp Profiles page

2 Select Identifiers from the sidebar Click the ldquo+rdquo button

3 Find and select the Merchant IDs from the list

Oct 07 2019 CyberSource Global Payment Management for Magento 2 57

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 61: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Figure 322 Register a New Identifier page

4 Fill in the Description and the Identifier field values Record the value of the Identifier as itrsquosrequired in the following configuration process Click the Continue button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 58

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 62: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Figure 323 Register a Merchant ID page

5 Click the Register button to finish the Merchant ID creation process

Figure 324 Finishing a new Merchant ID registration

3142 Creating Payment Processing certificate

A Payment Processing certificate is used to establish secure communication between Apple Pay andCyberSource

Oct 07 2019 CyberSource Global Payment Management for Magento 2 59

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 63: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

1 Log in to your CyberSource Enterprise business center account

2 On the left navigation panel go to ldquoPayment Configurationrdquo gt ldquoDigital Payment Solutionsrdquo

3 Click a ldquoConfigurerdquo button near ldquoApple Payrdquo item

4 Enter the value of your Apple Pay Merchant ID in the Apple Merchant ID field

Figure 325 CyberSource EBC Apple Pay configuration page

5 Click Generate New Certificate Signing Request button Save the generated CSR on your disk

6 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

7 Select Identifiers from the sidebar

8 Select your Merchant ID from the list

9 Under Apple Pay Payment Processing Certificate click the Create Certificate button

10 Select the CSR file you have downloaded from CyberSource EBC previously

Oct 07 2019 CyberSource Global Payment Management for Magento 2 60

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 64: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Figure 326 Uploading the Payment Processing Certificate Request

11 Click Continue button

12 Click Download button

Figure 327 Downloading a Payment Processing Certificate

3143 Domain validation

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

Oct 07 2019 CyberSource Global Payment Management for Magento 2 61

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 65: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

2 Select your Merchant ID from the list

3 Click Add Domain button under Merchant Domains

4 Enter your Store domain name into the field Click Continue button

Figure 328 Entering a domain name for validation

5 Download the validation file and save on your disk

Figure 329 Verifying a domain

6 Upload the validation file into your Website root directory into the well-known subdirectory

Oct 07 2019 CyberSource Global Payment Management for Magento 2 62

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 66: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

7 Make sure the file is accessible via Web

8 Click on the Validate button on the Verify page

9 Click the Done button to finish the Domain Validation process

3144 Creating Merchant Identity certificate

Merchant Identity certificate is used to authenticate your sessions on Apple Pay servers The certificateand its private key files must be uploaded to your server and full paths to these files must be enteredin CyberSource extension settings

1 Go to Certificates Identifiers amp Profiles page on your Apple Developer portal

2 Select your Merchant ID from the list

3 Click the Create Certificate button under Apple Pay Merchant Identity Certificate section

4 Generate your CSR following this Apple Developer Help article

5 Upload the CSR into the form and click Continue

Figure 330 Uploading the Merchant ID CSR

6 Click the Download button and save the Certificate on your disk

7 Convert the Certificate into PEM format

openssl x509 -inform der -in merchant_idcer -out merchant_idpem

8 Open the Keychain tool and find the Private Key for the CSR you have created on Step 4

Oct 07 2019 CyberSource Global Payment Management for Magento 2 63

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 67: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

9 From the context menu click Export and save the private key as merchant_idp12

Note Do NOT specify any password for the exported Private Key protection

10 Convert your Private Key into PEM format

openssl pkcs12 -in merchant_idp12 -out merchant_idkey -nodes

11 Upload converted Private Key merchant_idkey and Certificate merchant_idpem files in yourWebsite var directory

12 Enter full paths to the Certificate and Private key files in Magento Admin under Stores gt Config-uration gt Payment Methods gt CyberSource gt Apple Pay ldquoPath to certificaterdquo and ldquoPath to keyrdquofields respectively

Oct 07 2019 CyberSource Global Payment Management for Magento 2 64

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 68: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

3145 Extension configuration

Figure 331 Apple Pay configuration

Below are the settings which will help to configure the module

Oct 07 2019 CyberSource Global Payment Management for Magento 2 65

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 69: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Setting NotesEnabled This option activates or deactivates the Apple Pay methodTitle This text is displayed to customers as the name of this payment

method on the Checkout pageApple Merchant ID Enter your Apple Pay Merchant ID created in Section 3141Payment Action Set to Authorize Only to reserve funds during checkout and capture

during invoice creation Set to Authorize and Capture to authorizeand capture during customer checkout

Apple Display Name Defines business name the payer will see for the charge on a bank orcredit card statement For example ldquoCOMPANY INCrdquo

Certified Domain Validated Site Domain onwhich the service ismeant to be used MustNOT have https prefix See Section 3143

Path to Certificate A full path to the Merchant ID Certificate file See Section 3144Path to key A full path to the Merchant ID Certificate Private key file See Section

3144Sort Order Change the default payment method sort order here

Oct 07 2019 CyberSource Global Payment Management for Magento 2 66

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 70: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

315 Account Updater

Account Updater notifies you of changes to stored customer credit card data Such changes couldaffect expiration date credit card number or a brand If you use

CyberSource Recurring Billing Payment Tokenization or Token Management Services(TMS) Account Updater automatically updates the stored card data on your behalf

Account Updater obtains credit card information from both the Visa Incrsquos Account UpdaterService and the MasterCardrsquos Automatic Billing Updater Service

bull For Europe MasterCard only will be supported

Figure 332 Account updater settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 67

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 71: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Setting NotesEnabled This setting activates or deactivates the featureMerchant ID Required Your CyberSource Merchant IDUsername Required See Section 232Password Required See Section 232Update interval Define Account updater cronjob run frequency Recommended at

least once per monthManual Update Allows to process the report in manual mode Select the date to start

from and click the lsquoUpdatersquo button to startTest Mode If yes the account updater uses test endpoints for updating the

stored tokens Not for production useTest Report Path Allow to specify path of test Account Updater report file Path is

relative to Magentorsquos var directory Not for production use

Oct 07 2019 CyberSource Global Payment Management for Magento 2 68

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 72: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

316 Taxes

CyberSource offers a tax service that will calculate taxes to be charged on orders To do this there areseveral settings that must be configured to receive accurate results from CyberSource

Please note that this service must be enabled by your CyberSource representative before use Thisincludes activation for sandbox use as well as production use

Note Prior to Tax Calculation configuration one must configure SOAP Web Service See Section 32for detailed information on how to do so

To use the Tax Service your site will need to have the following features configured

bull Product Tax Class codes

bull CyberSource Tax Services settings

bull Magento Tax Settings

3161 Product Tax Classes

Each product in Magento has a setting for Tax Class This setting helps describe what the product isand how it should be taxed Contact your CyberSource representative for a list of available ProductTax Class IDrsquos and contact your tax consultant for advice on which Product Tax Class IDs you shoulduse for the products you sell Once you have that list you can add them to Magento

To do so in the Magento Admin section of your site navigate to Stores gt Tax Classes

Figure 333 Tax Classes Settings

Create a new Tax Class entry for each Tax Class ID provided by your CyberSource representativeEnter the lsquoTax Class Codersquo that was provided by CyberSource and select lsquoProductrsquo for the Tax ClassType setting

Oct 07 2019 CyberSource Global Payment Management for Magento 2 69

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 73: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Figure 334 Creating a new Tax Class

Once you have all the Tax Classes entered that you will use for your products you can configure yourproducts to use them

The Tax Class setting can be found inside each product record Use the dropdown control to selectan appropriate Tax Class and save the product record

Figure 335 Updating Tax Class settings on a product

Oct 07 2019 CyberSource Global Payment Management for Magento 2 70

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 74: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

3162 CyberSource Tax Services Settings

Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 71

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 75: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Figure 336 Tax Service Settings

Oct 07 2019 CyberSource Global Payment Management for Magento 2 72

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 76: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Setting NotesTax Calculation This setting activates or deactivates CyberSource Tax ServicesNexus Regions US and Canadian merchants have nexus in states or provinces in

which they have some form of physical presenceCustomer countries to cal-culate Tax for

Tax Services will be run for customer Shipping Addresses that arewithin the countries set here

Ship From City The City orders are shipped fromShip From Postcode The Postcode where orders are shipped fromShip From Country The Country where orders are shipped fromShip From Region The Region where orders are shipped fromAcceptance City This is the place of business where you acceptapprove the cus-

tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Postcode This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Country This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Acceptance Region This is the place of business where you acceptapprove the cus-tomerrsquos order thereby becoming contractually obligated tomake thesale

Origin City Point of Origin CityOrigin Postcode Point of Origin PostcodeOrigin Country Point of Origin CountryOrigin Region Point of Origin RegionMerchant VAT Referred to as the Merchant VAT Seller Registration Number

It is also possible to have taxes calculated for shipping rates In many cases if your site is offeringdynamic shipping rates from a carrier taxes may be included in the quoted shipping costs providedby carrier and presented to the customer However if you offer a flat rate shipping charge you maywish to add taxes to that flat rate

To do so you would navigate to Stores gt Configuration gt Sales gt Tax

Oct 07 2019 CyberSource Global Payment Management for Magento 2 73

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 77: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Figure 337 Magento settings for charging tax on shipping rates

Setting NotesTax Class for Shipping This is a product tax code that should reference taxes applied to ship-

ping services To add a value to the dropdown shown please refer-ence Section 3161

Shipping Prices Excluding Tax ndash shipping rates offered need to have taxes added tothemIncluding Tax ndash shipping rates offered have taxes included already sono taxes will be applied through the CyberSource tax service

Oct 07 2019 CyberSource Global Payment Management for Magento 2 74

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 78: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

317 Transactional Emails

In Magento Admin Marketing gt Email Templates gt DM Fail Transaction

When an order is flagged for Decision Manager Review the customer that placed the order is notinformed that their transaction has not been fully accepted

As a result if a manual review of the transaction leads to it being rejected the customer is informedthat their order is no longer active

This setting allows you to configure the email sent to customers in this case

318 Cron Settings

Stores gt Configuration gt Advanced gt System gt Cron (Scheduled Tasks) gt Cron configurationoptions for group dm

Figure 338 Magento Cron Panel

Please note all the values below are in minutes The only option you should edit is the first optionGenerate Schedules Every This is the Cron frequency A suitable time is every 15 minutes

Oct 07 2019 CyberSource Global Payment Management for Magento 2 75

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 79: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

4 Payment UX

The Secure AcceptanceWebMobile paymentmethod can be configured in twoways Using the Iframemode is a way to accept payments using a hosted payment page in a way that does not require thecustomer to leave the checkout page Alternatively the module can be configured as a traditionalredirect method where the customer is redirected to a hosted CyberSource webpage containing thesame payment web form

76

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 80: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

41 Using Iframe Mode

Figure 41 Secure Acceptance WebMobile configuration in iframe mode

When the module is configured for Iframe mode the payment screen looks like Figure 42 The ad-vantage of using this mode is that the customer never leaves the merchantrsquos website

Oct 07 2019 CyberSource Global Payment Management for Magento 2 77

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 81: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Figure 42 Checkout Payment Form in Iframe Checkout Mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 78

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 82: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

42 Using Redirect Mode

When the module is configured for Redirect mode the customer is redirected to a CyberSource URLto complete the payment step

Once the customer has completed payment they are redirected back to the merchantsrsquo website

Figure 43 Secure Acceptance WebMobile configuration in redirect mode

Oct 07 2019 CyberSource Global Payment Management for Magento 2 79

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 83: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

43 Tokens

When a logged in customer uses the checkout on your site their card data could be stored in a securedCyberSource datacenter Once saved a lookup value called a Token is provided to the merchantthrough this module and is stored against the Customer record When a returning customer usesyour checkout they can opt to use a previously used card and thereby avoid having to rekey theircard data

When a token is used the customer is still redirected either through an Iframe or through a full browserredirect action to the CyberSource Hosted Payment page for payment confirmation When a customerselects to checkout as a guest the token system is not used

431 Saving a card

To save the card log in or register a new customer account and select lsquoSave for later usersquo checkboxduring checkout process Once order is placed card information will be securely saved on Cyber-Source

Figure 44 Saving the card information for later use

432 Managing tokens

Logged in customers can remove their tokens at any time To do so they would visit the lsquoMy Accountrsquosection of Magento and select the lsquoStored Payment Methodsrsquo menu item

Use the Delete links beside any stored tokens to remove previously stored tokens

Oct 07 2019 CyberSource Global Payment Management for Magento 2 80

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 84: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

433 Paying with tokens

To pay the order with previously stored card just select it from the list on a top of lsquoBilling and reviewrsquocheckout step

Figure 45 Placing order with token

434 Migrating tokens created in version 2 to version 3

In version 2 the Module had its own implementation of token storage Version 3 has implemented theMagento Vault token storage to follow best practices The Module provides a simple and transparentway to migrate existing tokens from version 2 into Vault storage that will be executed automaticallyas a part of the usual extension upgrade process

Oct 07 2019 CyberSource Global Payment Management for Magento 2 81

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 85: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

44 Apple Pay

Have a look at the step by step procedure for Apple pay checkout at front store

Notice the Payment method while reviewing the order is Apple pay

Figure 46 Payment method selection

Apple Pay window will pop up requesting fingerprint (Touch ID) authentication) Optionally you mayselect one of your saved cards

Oct 07 2019 CyberSource Global Payment Management for Magento 2 82

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 86: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Figure 47 Card selection (optional)

Oct 07 2019 CyberSource Global Payment Management for Magento 2 83

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 87: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Figure 48 ApplePay interaction with Touch ID device

Now you should see order success page Verify the Transaction details in Business center

Oct 07 2019 CyberSource Global Payment Management for Magento 2 84

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 88: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

5 Administration Use

The Secure Acceptance WebMobile and Silent Order POST payment methods can be configured withtwo different payment modes

1 Authorize ndash transactions performed on the site while in this mode are Authorized only This onlyreserves funds and guarantees that later the merchant can Capture funds up to the reservedamount Capturing funds is done by preparing a Magento Invoice

2 Authorize and Capture ndash transactions performed in this mode are both Authorized and Capturedat the same time

85

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 89: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

51 Capturing Funds for Authorized Transactions

While in Authorize mode (see section 2) the system will create an Order record but it will not create aninvoice Capturing funds for Authorized transactions is done implicitly when you prepare an invoice

To prepare an invoice open a Payment Pending order and Click the lsquoInvoicersquo button

Figure 51 Admin view of payment pending order featuring the Invoice Button

When preparing an invoice make note of the section Items to Invoice Each line item listed can beindividually or partially invoiced by altering the Qty to Invoice column This is how multiple invoicescan be prepared for each order

Figure 52 Items to Invoice Section

To complete invoice creation and capture funds click the Submit Invoice button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 86

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 90: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Figure 53 Submit Invoice Button

52 Canceling Authorized Transactions

To cancel the transaction that has been Authorized but not Captured (an invoice has not yet beencreated for the order) open the order and select the Cancel or Void button on the order

The main difference between Cancel and Void operation is that cancelling will close the order afterAuthorization reversal while voiding will let you to create the offline invoice later

Figure 54 Cancel and Void order buttons

Oct 07 2019 CyberSource Global Payment Management for Magento 2 87

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 91: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

53 Refunding a Captured Order

To refund an order that has been captured a Credit Memomust be created Please note that there aretwo types of Credit Memos Offline Refunds and Online Refunds Offline refunds can be created fromthe main Order view page but no funds will be returned to the customer You will need to refund themoney using another way outside Magento

To refund customers in a way that triggers a credit of funds to the customerrsquos card you must preparea credit memo from the invoice record

Figure 55 Invoice Grid Showing Invoices Created for a Particular Order

Clicking View on an invoice will open the invoice and from there you can create an Online Refund bycreating a Credit Memo from within the Invoice Record

Figure 56 Credit Memo Button inside Invoice Record

When creating a Credit Memo you could refund all or part of an invoice To issue a partial refundalter the numbers in the column Qty to Refund Donrsquot forget to click lsquoUpdate Qtyrsquosrsquo button

Oct 07 2019 CyberSource Global Payment Management for Magento 2 88

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 92: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Figure 57 Quantity to Refund Column on Items to Refund Grid

To complete the Credit Memo click the Refund button

Figure 58 Credit Memo Summary Section with Refund Totals

Oct 07 2019 CyberSource Global Payment Management for Magento 2 89

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 93: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

54 Creating an order in the Admin

Figure 59 Creating new order with Silent Order POST

Simply create an order as you usually would Sales gt Orders gt Create New Order

Oct 07 2019 CyberSource Global Payment Management for Magento 2 90

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 94: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

Figure 510 Order confirmation

Note CyberSource PayPal is not available with create order in the Magento Admin

Oct 07 2019 CyberSource Global Payment Management for Magento 2 91

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 95: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

6 CyberSource Documentation

The CyberSource extension utilizes services and connection methods found in the following relateddocumentation

bull Secure Acceptance WebMobile

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_WMSecure_Acceptance_WMpdf

bull Secure Acceptance Silent Order POST

httpappscybersourcecomlibrarydocumentationdev_guidesSecure_Acceptance_SOPSecure_Acceptance_SOPpdf

bull SOAP Toolkit API

httpappscybersourcecomlibrarydocumentationdev_guidesSOAP_ToolkitsSOAP_toolkitspdf

bull Credit Card Services

httpappscybersourcecomlibrarydocumentationdev_guidesCC_Svcs_SO_APICredit_Cards_SO_APIpdf

bull Decision Manager

ndash Developer Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Dev_Guide_SO_APIDM_developer_guide_SO_APIpdf

ndash Device Fingerprinting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Device_Fingerprint_GuideDecisionManagerDeviceFingerprintpdf

ndash Reporting Guide

httpsebctestcybersourcecomebctestdocumentationresourceDM_Report_GuideDMReportingGuidepdf

bull Payment Authentication Services

httpappscybersourcecomlibrarydocumentationdev_guidesPayer_Authentication_SO_APIPayer_Authentication_SO_APIpdf

92

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation
Page 96: CyberSource Global Payment Management for Magento 2 · 2019-12-06 · RecentChanges Version Release Changes 1.0.0 March2017 InitialRelease 2.0.0 August2017 Added support for Secure

bull Token Management Services

httpappscybersourcecomlibrarydocumentationdev_guidesToken_ManagementSO_APITMS_SO_APIpdf

bull PayPal Express Checkout Services

Available on request

bull Online Bank Transfer Services

httpappscybersourcecomlibrarydocumentationdev_guidesOnlineBankTransfers_SO_APIOnlineBankTransfers_SO_APIpdf

bull Electronic Check Services

httpappscybersourcecomlibrarydocumentationdev_guidesEChecks_SO_APIElectronic_Checks_SO_APIpdf

bull Klarna Services

httpappscybersourcecomlibrarydocumentationdev_guidesKlarna_SO_APIKlarna_SOpdf

bull Visa Checkout

httpappscybersourcecomlibrarydocumentationdev_guidesVCO_SO_APIVisa_Checkout_SO_APIpdf

bull Apple Pay

httpappscybersourcecomlibrarydocumentationdev_guidesapple_paymentsSO_APIApple_Pay_SO_APIpdf

bull Tax Calculation Service

httpappscybersourcecomlibrarydocumentationdev_guidesTax_SO_APITax_SO_API

bull Delivery Address Verification Services

httpappscybersourcecomlibrarydocumentationdev_guidesVerification_Svcs_SO_APIVerification_Svcs_SO_APIpdf

bull Account Updater

httpappscybersourcecomlibrarydocumentationdev_guidesAccount_Updater_UGAccount_Updaterpdf

bull Reporting Developer Guide

httpappscybersourcecomlibrarydocumentationdev_guidesReporting_Developers_GuideReporting_DGpdf

Oct 07 2019 CyberSource Global Payment Management for Magento 2 93

  • Introduction
    • Payment Tokenization with Secure Acceptance
    • Credit Card Services
    • Decision Manager
    • Account Takeover Protection
    • Payer Authentication (3-D Secure)
    • PayPal Express Checkout
    • Electronic Check (eCheck)
    • Online Bank Transfers
    • Tax Calculation
    • Delivery Address Verification
    • PayPal Credit
    • Visa Checkout
    • Klarna
      • CyberSource Configuration
        • Secure Acceptance Configuration
        • Decision Manager
        • Security Credentials
        • Backend Setup
          • Magento Backend Configuration Settings
            • General Settings
            • SOAP Web Services Settings
            • E-Check
            • Secure Acceptance WebMobile
            • Token Management Service
            • 3D Secure 20
            • Delivery Address Verification Service
            • Klarna
            • Secure Acceptance Silent Order Post (SOP)
            • PayPal Express Checkout
            • Device Fingerprint
            • Bank Transfer
            • Visa Checkout
            • Apple Pay
            • Account Updater
            • Taxes
            • Transactional Emails
            • Cron Settings
              • Payment UX
                • Using Iframe Mode
                • Using Redirect Mode
                • Tokens
                • Apple Pay
                  • Administration Use
                    • Capturing Funds for Authorized Transactions
                    • Canceling Authorized Transactions
                    • Refunding a Captured Order
                    • Creating an order in the Admin
                      • CyberSource Documentation