Cybersource Implementation guide
15 minutes to read
|
🛈 Important This topic applies only to Cybersource |
This section guides you through the discrete implementation steps in order to complete a successful implementation.
Specification
Review the specification for the MAX Pay Global payment connector to ensure it meets your requirements, prior to deployment.
Retail Realm prerequisites
- MAX Pay Global for Dynamics 365 Finance / Commerce LCS packages.
- MAX Pay Global test / production licenses.
Prerequisite tasks and information required
You will require the following prerequisite pieces of information and tasks to be completed prior to implementing MAX Pay Global:
|
Item |
Task/Description |
Required |
From |
Sample value |
|
Azure service |
You will require an Azure hosted Service to house the Hosted payment page. |
Yes |
|
|
|
Access to the Cybersource EBC Portal |
• Test Environment: https://ebc2test.cybersource.com/ebc2 • Production Environment: https://ebc2.cybersource.com/ebc2 |
Yes |
Contact Cybersource |
|
|
Profile ID |
Create a profile in Cybersource. You will require the Profile ID to be pasted into Payment services. |
Yes |
|
|
|
Access key and Secret key |
You will require an Access key and associated Secret key from Cybersource. Navigate to: For further details and instructions, follow this link: https://docs.cybersource.com/en/admin/admin.html For further advice, please contact your Cybersource representative Access and Secret keys will be different for Live and Test Note, the Secret key length is 256 characters and must be split into two (refer to the relevant Payment services profile for further details). |
Yes |
Cybersource |
|
|
Soap Key |
You will require a Soap key From the EBC Portal, Navigate to Settings > Payment Configuration > Key Management > + Generate key Soap keys are typically 345 characters in length and must be split to accommodate the Merchant properties within a given Profile (E.g. Payment services) Three fields are provided for this purpose. |
|
|
|
|
Test card numbers |
Test card numbers Start by looking at this page https://developer.cybersource.com/hello-world/testing-guide-v1.html Also refer to this https://developer.cybersource.com/hello-world/testing-guide.html |
Yes |
Cybersource |
|
Installation steps
This section describes the specific installation steps
|
# |
Item |
Required |
Navigation |
Notes |
|
1 |
Obtain the deployable packages from Retail Realm |
Yes |
Request these from your Retail Realm project manager |
|
|
2 |
Deploy the packages to your environment using LCS |
Yes |
|
|
|
3 |
Configure Retail scheduler |
Yes |
|
|
|
4 |
Configure Shared parameters (Common) |
Yes |
|
|
|
5 |
Configure the shared parameters for your chosen payment provider |
Yes |
|
|
|
6 |
Configure Payment services |
Yes |
|
|
|
7 |
Configure Commerce POS |
Optional |
|
Only carry out this if you are using Commerce and using the Point of sale |
|
8 |
Configure Call center |
Optional |
|
Only carry this out if you are using Call enter |
|
9 |
Configure e-Commerce |
Optional |
|
Only carry this out if you are using Microsoft e-Commerce Store Front |
|
10 |
Apply license(s) |
Yes |
|
Applying the licensing is required prior to performing a payment transaction but not required to install and configure |
|
11 |
Perform a test transaction |
Yes |
|
Once you have completed your configuration, perform a test transaction |