Guides
  1. processors
  2. Cybersource

Connecting Cybersource

Cybersource is an enterprise gateway that is often white-labelled by other brands. It is common to use this integration to connect to an alternatively branded platform such as NAB (National Australia Bank).

To connect to Cybersource you need three credentials:

  • Organisation ID
  • Key ID
  • Secret Key

The Organisation ID is the one you use to access the Cybersource console. It is an alphanumeric string.

Cybersource console login screen, showing the Organization ID field

  1. Log into the Cybersource (or alternatively branded) console, and navigate using the left-hand menu to Payment Configuration then Key Management, and select + Generate Key.

    Cybersource Key Management screen with Payment Configuration, Key Management, and Generate key highlighted

  2. A Create Key screen will display. It should be pre-populated with the correct values — you just need REST APIs using a REST - Shared Secret. Confirm this is all that is selected and choose Generate Key.

    Create Key screen with REST - Shared Secret and Generate key highlighted

  3. Note down (or download) the Key and Shared Secret.

    📘

    Tip

    You will not be able to access the Shared Secret again once you close this window. Save it now.

    Key Generation screen showing the generated Key and Shared Secret with a Download key button

  4. In Shuttle, enter the Organisation ID, Key, and Shared Secret. In Gateway Type, select the brand you are working with (for example Cybersource, NAB, or another bank). If the brand is not listed, select Other and notify [email protected].

    Shuttle Add Cybersource form with Organization ID, Key, Shared Secret, Gateway Type, and connection option checkboxes

  5. Once connected, you will be presented with a green "Connected to Cybersource" message. The Shared Secret will not be displayed.

    Shuttle Connected to Cybersource confirmation message with MID and Key ID

Connection options

Our integration with Cybersource offers several options:

  • Require address (AVS): Requires the customer to enter their billing address. This is currently required to be selected by NAB customers.
  • Enable 3DS: If you have 3DS enabled on your Cybersource account, select this to ensure secure customer authentication is applied to appropriate transactions.
  • Enable Multi Currency: Cybersource supports both multi-currency and single currency configurations. If you have a single currency account, currency is ignored by Cybersource — deselect this and select the currency of your account when prompted. NAB users must deselect this and choose AUD.
  • Enable Card Saving: Allows card vaulting (tokenisation) on your account. Confirm with your gateway that you are able to access this feature, then select this checkbox accordingly.

For sandbox testing details, see Cybersource Sandbox Credentials.