Skip to content
ShuttleShuttle Docs
Status
View as MarkdownPlain text for AI toolsOpen in ClaudeAsk questions about this pageOpen in ChatGPTAsk questions about this pageOpen in GitHub CopilotAsk questions about this page

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:

  • Organization ID
  • Key
  • Shared Secret Key

The Organization 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.

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

  4. In the setup screen, enter the Organization ID, Key, and Shared Secret Key (the Shared Secret from the previous step). 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 support@shuttleglobal.com.

    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 Key will not be displayed.

    Connected to Cybersource confirmation message with MID and Key ID

Connection options

Section titled “Connection options”

Our integration with Cybersource offers several options:

  • Address Verification: How much of the billing address the customer is asked for. NAB customers must choose one of the address options; NAB requires AVS.
    • Disabled (the default): no address requested.
    • Full Address (incl. email): billing address and email address.
    • Full Address (relaxed): billing address.
    • Zip Only (relaxed): billing postcode only.
  • 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 Cards 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.

Was this page helpful?