Cybersource

Cybersource Salesforce Order Management Package

Cybersource Contact Information
For general information about our company, products, and services, go to http://www.cybersource.com.
For sales questions about any Cybersource Service, email sales@cybersource.com or call 650-432-7350 or 888-330-2300 (toll free
in the United States).
For support information about any Cybersource Service, visit the Support Center: http://www.cybersource.com/support

Copyright
© 5/22/20 Cybersource Corporation. All rights reserved. Cybersource Corporation (“Cybersource”) furnishes this document and the
software described in this document under the applicable agreement between the reader of this document (“You”) and Cybersource
(“Agreement"“. You may use this document and/or software only in accordance with the terms of the Agreement. Except as expressly
set forth in the Agreement, the information contained in this document is subject to change without notice and therefore shou ld not be
interpreted in any way as a guarantee or warranty by Cybersource. Cybersource assumes no responsibility or liability for any errors
that may appear in this document. The copyrighted software that accompanies this document is licensed to You for use only in strict
accordance with the Agreement. You should read the Agreement carefully before using the software. Except as permitted by the
Agreement, You may not reproduce any part of this document, store this document in a retrieval system, or transmit this docum ent,
in any form or by any means, electronic, mechanical, recording, or otherwise, without the prior written consent of Cybersource.

Restricted Rights Legends

For Government or defense agencies: Use, duplication, or disclosure by the Government or defense agencies is subject to
restrictions as set forth the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 and in similar clauses
in the FAR and NASA FAR Supplement.
For civilian agencies: Use, reproduction, or disclosure is subject to restrictions set forth in subparagraphs (a) through (d) of the
Commercial Computer Software Restricted Rights clause at 52.227-19 and the limitations set forth in CyberSource Corporation's
standard commercial agreement for this software. Unpublished rights reserved under the copyright laws of the United States.

Trademarks
Authorize.Net, eCheck.Net, and The Power of Payment are registered trademarks of Cybersource Corporation. Cybersource,
Cybersource Payment Manager, Cybersource Risk Manager, Cybersource Decision Manager, and Cybersource Connect are
trademarks and/or service marks of Cybersource Corporation. Visa, Visa International, Cybersource, the Visa logo, and the
Cybersource logo are the registered trademarks of Visa International in the United States and other countries. All other trademarks,
service marks, registered marks, or registered service marks are the property of their respective owners.

Confidentiality Notice
This document is furnished to you solely in your capacity as a client of Cybersource and as a participant in the Visa payments
system.
By accepting this document, you acknowledge that the information contained herein (the “Information”) is confidential and subject to
the confidentiality restrictions contained in Visa's operating regulations and/or other confidentiality agreements, which limit your use
of the Information. You agree to keep the Information confidential and not to use the Information for any purpose other than its
intended purpose and in your capacity as a customer of Cybersource or as a participant in the Visa payments system. The
Information may only be disseminated within your organization on a need-to-know basis to enable your participation in the Visa
payments system. Please be advised that the Information may constitute material non-public information under U.S. federal
securities laws and that purchasing or selling securities of Visa Inc. while being aware of material non-public information would
constitute a violation of applicable U.S. federal securities laws.

Revision: May 2022

Visa Confidential Salesforce Order Management Technical Installation Guide | 2

Contents
Cybersource Salesforce Order Management Package ............................................................... 1
Cybersource Contact Information...................................................................................................... 2
Copyright ......................................................................................................................................... 2
Restricted Rights Legends ................................................................................................................. 2
Trademarks ...................................................................................................................................... 2
Confidentiality Notice ....................................................................................................................... 2
Introduction ..................................................................................................................................... 4
Installation ....................................................................................................................................... 4
Step 1: Install the managed packaged .......................................................................................................................4
Step 2: Create a Payment Gateway Provider ............................................................................................................4
Step 4: Create a Payment Gateway Record...............................................................................................................6
Step 6: Test and go live ..............................................................................................................................................8
Ready to Go Live ........................................................................................................................................................8

Upgrade Package .............................................................................................................................. 8

Release Notes................................................................................................................................... 9

Visa Confidential Salesforce Order Management Technical Installation Guide | 3

Introduction
The Salesforce Order Management app brings together tools that help you manage orders while delivering
seamless, omnichannel commerce experiences to your customers. It is integrated with B2C Commerce and natively
supports Service Cloud to provide a single view of order and service history.
With Salesforce Order Management:
• Consumers can submit orders from any commerce channel, and then track and manage their orders
throughout the order lifecycle.
• Merchants can manage order fulfillment, shipping, payment capture, invoicing, and service by using
integrated and customizable business processes and workflows.
• Service agents can access a master repository of all order-related information to see a global view of the
entire order lifecycle, and process cancellations and returns.

Installation
Follow the below steps to install and configure the “Cybersource for Lightning Order Management” managed
package.

Step 1: Install the managed packaged

Install the managed package from Salesforce App exchange (https://appexchange.salesforce.com/) by searching
for “Cybersource for Lightning Order Management”.

Step 2: Create a Payment Gateway Provider

Creating Payment Gateway Provider is currently NOT supported from the UI and should be done through
workbench by connecting to your organization:
1. Endpoint to be used - (MD/ToolingAPI):
/services/data/v48.0/tooling/sobjects/PaymentGatewayProvider
2. Payload :
{
"ApexAdapterId":< ID of PTS_PaymentAdapter.cls apex class>,
"DeveloperName":"Cybersource_Provider",
"MasterLabel":" Cybersource_Provider ",
"IdempotencySupported":"Yes",
"Comments":"Comments"
}

Step 3: Create a Named Credentials Record.

The Package comes with a default named credential – Payment that points to Cybesource’s test endpoint
https://apitest.cybersource.com.
If you face any issue looking up this Named credential, then create a new Named Credential by following the below
steps:
1. Click Setup.

Visa Confidential Salesforce Order Management Technical Installation Guide | 4

 2. In the quick find box, enter Named Credentials.
3. Click New.
4. Fill in the fields.
Field Name Description/Value

Label Label for your named credential – Payment_TEST or

Payment_LIVE

Name Preferred to have same value that of the Label field.

URL URL of your endpoint. For TEST Environment, the value will
be https://apitest.cybersource.com. For
PRODUCTION/LIVE environment, the value will be
https://api.cybersource.com

Certificate Leave the field blank.

Identity Type Set value to Anonymous.

Authentication Protocol Set value to No Authentication.

Generate Authorization Deselect the checkbox.

Header

Allow Merge Fields in Select the checkbox.

HTTP Header

Allow Merge Fields in Select the checkbox.

HTTP Body

5. Click Save.

Visa Confidential Salesforce Order Management Technical Installation Guide | 5

Step 4: Create a Payment Gateway Record
1. Click on App Launcher > Payment Gateways.
2. Click New.
3. Enter the required details:
Field Description/Value

Payment Gateway Name Name of your payment gateway.

Payment Gateway Provider Name of your payment gateway provider created in Step 2.

Merchant Credential If this environment is your Test Environment, then the

value will be “Payment” or “Payment_TEST” (created in
Step 3).

If this is your Live/Production Environment, then the value

will be “Payment_LIVE” or the name of your Named
Credential created in Step 3 that points to Cybersource
PRODUCTION/LIVE endpoint.
Status Possible values:
• Active
• Inactive
In order to activate this payment gateway, select Active.

External Reference This value will be the Processor ID from your salesforce
commerce cloud instance. You can see your processor ID by
navigating to Merchant Tools > Ordering > Payment
Processors in your salesforce commerce cloud instance.
For payment methods, navigate to Merchant Tools >
Ordering > Payment Methods. In order to see which
payment processor is associated with the payment method,
click on the payment method, and scroll down to see the
payment processor associated with it.
NOTE: If you are using different payment processors, then
you need to create different payment gateway records for
each payment processor each having a unique payment
processor ID on the External Reference field.

Comments Any comments that you want to assign.

Visa Confidential Salesforce Order Management Technical Installation Guide | 6

 4. Click Save.

Step 5: Create a Payment Configuration Record Prerequisite:

If you are new to Cybersource and would like to start using Cybersource managed package quickly, begin by signing
up for a Sandbox Account.

You will also need to create an API Key and API Shared Secret Key that you can use to authenticate requests to our
sandbox server. Follow the same steps to generate the Production key and shared secret.

Follow the below steps to create a Payment Configuration Record. If you support multi-site configuration for
different Merchant ID then create separate records for each Merchant ID and each sales channel.

1. Go to Setup
2. In the quick find box, enter “Custom Metadata Types”
3. Click on “Payment Configuration (Managed)”
4. Click on “Manage Payment Configurations”
5. Click on “New”
6. Enter the required details:
Field Description/Value

Label Should match with the Salesforce Commerce Cloud site ID

(saleschannel) which can be found by looking up this can be
found by looking up Administration->Sites->Manage Sites

Payment Configuration Preferred to have the same value that of Label field.
Name

Merchant ID Your Merchant ID.

End Point TEST or PRODUCTION

REST Key ID This value is generated in the Business Center.

Visa Confidential Salesforce Order Management Technical Installation Guide | 7

 REST Shared Key This value is generated in the Business Center.

Developer ID Unique identifier generated by Cybersource for

System Integrator

For instructions on how to generate a Key ID and shared key in the Business Center, see the Getting Started guide.

7. Click Save.

NOTE: Payment_Confg__c custom object has been deprecated from “Cybersource for Lightning Order Management
v1.4” so don’t create any record in this object.

Step 6: Test and go live

Before you start accepting payments, test your integration in Test sandbox:

The sandbox simulates the live payment gateway. The sandbox never processes an actual payment. We
do not submit sandbox transactions to financial institutions for processing. The sandbox environment is
completely separate from the live production environment, and it requires separate credentials. If you
use your production credentials in the sandbox or vice versa, you get a 401 HTTP error.
Test your integration, and configure your live account, so you can start processing live transactions.

Ready to Go Live
1. Install the managed packaged in Production Org.
2. Create a new Payment Gateway Provider record in your Production Org by following steps in Step 2.
3. Create a new named credential – “Payment_LIVE” in your Production Org by following steps in Step 3.
4. Create a new Payment Gateway record in your Production Org by following steps in Step 4.
5. Create a new Payment Configuration custom metadata record in your Production org by following steps in
Step 5. If you support multi-site configuration for different Merchant ID then create separate records for
each Merchant ID and each sales channel. Make sure the Endpoint field is selected PRODUCTION.

Upgrade Package
Follow the standard salesforce process to upgrade the “Cybersource for Lightning Order Management“
package. Please refer to this link for more details.
Visa Confidential Salesforce Order Management Technical Installation Guide | 8
Release Notes
Version 2.0.0 (May 15, 2022)

• We have added capture for PayPal payment method.

• We have added refund for PayPal payment method.

Version 1.1.0

• We have added multi-capture capabilities for credit card, Apple Pay and Google pay.

Version 1.0.0

• We have added capture for credit card, Apple Pay and Google Pay.
• We have added refund for credit card, Apple Pay and Google Pay.

Visa Confidential Salesforce Order Management Technical Installation Guide | 9