> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gr4vy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CyberSource

> Connect to CyberSource to accept card payments and local payment methods.

Cybersource is a Visa solution that provides global card processing, risk management, and payment acceptance tools for enterprises and online businesses. The platform supports comprehensive payment processing with advanced features for merchants worldwide.

## Supported payment methods

| Method                       | Countries           | Currencies            | Notes                             |
| ---------------------------- | ------------------- | --------------------- | --------------------------------- |
| [Card](./cybersource-card)   | `AT`, `AU`, 38 more | `AED`, `AFN`, 95 more | Card processing via Cybersource.  |
| [iDEAL](./cybersource-ideal) | `NL`                | `EUR`                 | Bank redirect in the Netherlands. |
| [KCP](./cybersource-kcp)     | `KR`                | `KRW`                 | Bank redirect in South Korea.     |

## Setup

To sign-up for a Cybersource account, request a
[sandbox account](https://developer.cybersource.com/hello-world/sandbox.html),
this can take 1-2 days.

## Credentials

When setting up Cybersource in the dashboard, configure the
following credentials, which are obtained from Cybersource Business Center:

**Merchant ID:** this is the Cybersource assigned Merchant ID for the account. You can find it in the Cybersource Business Center.

<Frame caption="Cybersource Merchant ID">
  <img src="https://mintcdn.com/gr4vy/81rUFzs1xxqEKdRI/connections/assets/cybs_merchant_id.png?fit=max&auto=format&n=81rUFzs1xxqEKdRI&q=85&s=400313348652d7250a713ac8ce65be23" alt="" width="726" height="197" data-path="connections/assets/cybs_merchant_id.png" />
</Frame>

**Secret key:** create a REST API Shared Secret Key. This is also documented on the [Cybersource Knowledge Base](https://support.cybersource.com/knowledgebase/Knowledgearticle/?code=000002926).

1. Sign in to the Cybersource Business Center (Test or Production) where the key is used
2. Select Payment Configuration > Key Management
   <Frame caption="Cybersource Key Management Menu">
     <img src="https://mintcdn.com/gr4vy/81rUFzs1xxqEKdRI/connections/assets/cybs_key_management.png?fit=max&auto=format&n=81rUFzs1xxqEKdRI&q=85&s=ad544d0a814aa377a075748d012a6488" alt="" width="287" height="722" data-path="connections/assets/cybs_key_management.png" />
   </Frame>
3. Select Generate Key at the top right
   <Frame caption="Cybersource Generate Key">
     <img src="https://mintcdn.com/gr4vy/81rUFzs1xxqEKdRI/connections/assets/cybs_generate_key.png?fit=max&auto=format&n=81rUFzs1xxqEKdRI&q=85&s=155725baa187c138d3b82110f979d8eb" alt="" width="1591" height="368" data-path="connections/assets/cybs_generate_key.png" />
   </Frame>
4. From the list, make sure to check the radio button for REST APIs - REST - Shared Secret Key
   <Frame caption="Cybersource Create Key">
     <img src="https://mintcdn.com/gr4vy/81rUFzs1xxqEKdRI/connections/assets/cybs_create_key.png?fit=max&auto=format&n=81rUFzs1xxqEKdRI&q=85&s=021d93fa97976893671c10bb36c20ca5" alt="" width="1046" height="816" data-path="connections/assets/cybs_create_key.png" />
   </Frame>
5. Click Generate Key at the bottom
   <Frame caption="Cybersource Complete Generate Key">
     <img src="https://mintcdn.com/gr4vy/81rUFzs1xxqEKdRI/connections/assets/cybs_complete_generate_key.png?fit=max&auto=format&n=81rUFzs1xxqEKdRI&q=85&s=1c9b4e78dcba06d4bfcbbc04bb2af18b" alt="" width="968" height="741" data-path="connections/assets/cybs_complete_generate_key.png" />
   </Frame>
6. Click on Download Key or copy the keys using the copy function next to Key and Shared Secret
   <Frame caption="Cybersource Key ID">
     <img src="https://mintcdn.com/gr4vy/81rUFzs1xxqEKdRI/connections/assets/cybs_download_key.png?fit=max&auto=format&n=81rUFzs1xxqEKdRI&q=85&s=9aa9ea371e0dc379dd137a251c11db9c" alt="" width="974" height="703" data-path="connections/assets/cybs_download_key.png" />
   </Frame>

### Key ID

After creating a Shared Secret Key (see preceding), obtain the `Key ID` by following these steps:

1. Go to Payment Configuration > Key Management
   <Frame caption="Cybersource Key Management Menu">
     <img src="https://mintcdn.com/gr4vy/81rUFzs1xxqEKdRI/connections/assets/cybs_key_management.png?fit=max&auto=format&n=81rUFzs1xxqEKdRI&q=85&s=ad544d0a814aa377a075748d012a6488" alt="" width="287" height="722" data-path="connections/assets/cybs_key_management.png" />
   </Frame>
2. Find the key from the list
   <Frame caption="Cybersource Generate Key">
     <img src="https://mintcdn.com/gr4vy/81rUFzs1xxqEKdRI/connections/assets/cybs_find_key.png?fit=max&auto=format&n=81rUFzs1xxqEKdRI&q=85&s=95161c2c8e30a9367888c6b1d653d936" alt="" width="1564" height="637" data-path="connections/assets/cybs_find_key.png" />
   </Frame>
3. The `Key ID` is listed below the `Key Detail` title
   <Frame caption="Cybersource Merchant ID">
     <img src="https://mintcdn.com/gr4vy/81rUFzs1xxqEKdRI/connections/assets/cybs_key_id.png?fit=max&auto=format&n=81rUFzs1xxqEKdRI&q=85&s=3dd628e8e4748807779a248577673f1d" alt="" width="1112" height="681" data-path="connections/assets/cybs_key_id.png" />
   </Frame>
