Generating Secure Acceptance Credentials
To configure CyberSource within the Elastic Path Payments framework, you must create a security certificate and Secure Acceptance Profile in the Cybersource administrative console. Elastic Path makes secure calls to CyberSource for operations such as, pre-authorization, capture, and credit.
Creating a Security Certificate
important
Ensure that you install the latest Java Runtime Environment. If you don’t have the latest installed, the certificate generation process may stop responding.
Sign in to the CyberSource console using either the Sandbox admin console or the Production admin console.
In the CyberSource console, go to Payment Configuration > Key Management.
Click Generate Key, located in the upper right corner of the page.
Select Transaction Processing.
Click Next Step.
Select Simple Order.
Click Submit.
Click Keep when the security warning appears.
Open the file. A warning message may appear.
Click Run if prompted.
Click Generate Certificate Request.
Click Continue.
In the Save dialog box, select a location to save the key file.
note
The filename of the certificate is
{merchantid}.p12
.
Deploying Security Certificates
After you generate the certificate, deploy it into a folder on the EP Cortex Docker
containers.
Modify the Docker scripts to retrieve the certificate from a secure S3 bucket at startup, based on your current environment, such as development or production.
- Determine the certificate folder path, such as
COMMERCE/SYSTEM/PAYMENTGATEWAY/certificatesDirectory
. - Determine the certificate file path, such as
COMMERCE/SYSTEM/PAYMENTGATEWAY/certificateFile/{merchantid}.p12
.
- Determine the certificate folder path, such as
Deploy the certificate into a folder on the
EP Cortex Docker
containers.
Generating Secure Acceptance Credentials
Elastic Path CyberSource Signing Lambda API requires the secure acceptance credentials to securely generate a token based on a customer’s credit card details. These details are only transmitted or stored on the CyberSource network, not on the Elastic Path network.
Go to Payment Configuration > Secure Acceptance Settings
Click New Profile, located in the upper right corner of the page.
Enter a profile name, such as Elastic Path Secure Acceptance Profile.
Select an integration method:
- Select Checkout API for Direct Post to host the payment information fields on your own checkout pages.
- Select Hosted Checkout for Hosted Page to redirect the shopper to the CyberSource hosted payment page.
Enter the company name and contact information.
In Added Value Services, click Payment Tokenization.
note
If you don’t see the payment tokenization option, it is not enabled on your CyberSource account. Contact CyberSource support.
Click Submit.
Click the Payment Settings tab.
Select the card types that you want to accept.
Click the Security tab.
In the Security Keys list, click +.
Give the key a name, such as CyberSource Signing Lambda, and leave the other options as default.
Click Create.
Copy the access key and secret key.
warning
The secret key disappears within 30 seconds.
Click Customer Response.
Enter a URL to save the profile.
The URL can be any URL, such as
https://www.sampleurl.com
. The URL is overridden by the request.
- Click Save to make the profile active.
- Click the checkbox icon to promote the profile.
Ensure that you note the following values which you need to use to populate the CyberSource Signing Lambda configuration:
- Secure Acceptance Profile ID
- Secure Acceptance Access Key
- Secure Acceptance Secret Key