Integrating Cybersource


Storeganise uses the Secure Acceptance Hosted Page Checkout integration method for Cybersource

In order to integrate with Storeganise, your Cybersource account must have TMS, or Token Management Service, enabled. Contact Cybersource support to have this service enabled on your account prior to setting up the Storeganise integration outlined in this article.

TIP: If you see the setting tab 'Token Management' in your Cybersource account sidebar, this typically indicates this service is already enabled for your account.

Seen in your account sidebar
The following steps detail how to configure settings in your Cybersource dashboard to integrate with Storeganise. During this process you will generate several important data points that must be later shared with Storeganise support staff.It is very crucial to save these data points in a separate document file while going through this process.

1. Connect to your dashboard https://{sub}.cybersource.com/ebc2/ where {sub} is your Cybersource account provided by your Cybersource contact with your credentials

2. Go to Payment Configuration > Key Managementhttps://{sub}.cybersource.com/ebc2/app/PaymentConfiguration/KeyManagement
  • Click "+ Generate key"
  • Choose REST - Shared Secret
  • Click "Generate key" button and download the 2 keys shown:
API Key ID (Key)API Secret Key (Shared Secret)

YOU CANNOT VIEW THE 'Shared Secret' KEY AFTER THIS STEP

Make sure that you click the 'Download key' button to save this information.

If you do not record this information you must delete the REST key and this step will need to be repeated.

3. Go to Payment Configuration >  Secure Acceptance Settingshttps://{sub}.cybersource.com/ebc2/app/PaymentConfiguration/SecureAcceptanceSettingsCreate a Profile:
  • Click '+ New profile'
  • Enter a 'Profile Name' of your choosing
  • Select 'Hosted Checkout'
  • Enter your 'Company Name'
  • Set 'Payment Tokenization' to ENABLED
  • Click 'Submit'
Copy and save your Secure Acceptance Profile ID
While going through each tab below, you may need to scroll to the bottom of the page and click 'Save' before proceeding to the next tab.
  • GENERAL SETTINGS
    • Integration methods: Hosted Checkout
    • Added Value Services: Payment Tokenization Enabled
  • PAYMENT SETTINGS
    • Card Type: Click 'Add card type' and select a card type (e.g., Visa)
    • CVN: Toggle on 'CVN Display' and 'CVN Required'
    • Currencies: Select the currencies for your business
    • Scroll to the bottom and click 'Submit'
    • Repeat these steps for each desired card type
    • You can enable Card Detection if it's supported
  • SECURITY
    • Click 'Create key'
    • Enter a 'Key Name' of your choosing and click 'Create'
    • Copy and save the Secure Acceptance Access Key and Secure Acceptance Secret Key
  • PAYMENT FORM
    • Payment Form Flow: Select 'Single Page Form'
    • Checkout Steps: Enable 'Billing Information'
    • Billing Information: Toggle on 'Display', 'Edit', and 'Require' for each of the following fields:First NameLast NameStreet Address 1CityState (US/Canada)Zip/Postal CodeCountryEmail
It's possible these settings can vary based on your region. Reach out to Storeganise support if you are uncertain.
Once each tab is configured, make sure to click "Promote profile"
4. Once you have the following information:
  • Environment (Test, Production or ProductionIndia)
  • Merchant ID (found in a banner at the top of your Cybersource dashboard)
  • Currency (currency code e.g. EUR)
  • API Key ID
  • API Secret Key
  • Secure Acceptance Profile ID
  • Secure Acceptance Access Key
  • Secure Acceptance Secret Key
Go to https://onetimesecret.com/ and paste all of this information, ensuring it is clearly labeled, in the 'Secret content goes here....' field. Then click the 'Create a secret link*' button. Example below:
Once you have your unique secret link URL, please contact us at support@storeganise.com with this link and we will advise you on the next steps to complete the integration of your Storeganise instance with your Cybersource merchant.

Using Cybersource in a custom configuration

- GET /v1/billing/cybersource/sources - list available payment methods- POST /v1/billing/cybersource/session - returns { action: String, data: Object } to be used in a form for starting the checkout flow, as shown below:
const session = await fetch('https://spaceup.storeganise.com/api/v1/billing/cybersource/session?successUrl=' + encodeURIComponent(location.href), {
  method: 'POST',
  // credentials: 'include', // if using cookies
  headers: { authorization: `Bearer ${accessToken}` },
}).then(r => r.json());
const form = document.createElement('form');
form.action = session.action;
form.method = 'POST';
form.append(
  ...Object.entries(session.data).map(([name, value]) => {
    const input = document.createElement('input');
    return Object.assign(input, { type: 'hidden', name, value });
  })
);
document.body.append(form);
form.submit();
Note: You must first have created a user account before attaching Cybersource cards using the above endpoints
Integrating Cybersource