# Cybersource Integration Cybersource Hero Cybersource, a Visa-owned payment gateway, enables secure online payments and fraud management. When integrated with Finix, Cybersource acts as the gateway layer, routing transactions to acquiring banks and card networks. Merchants can retain their existing checkout solutions while leveraging Finix’s merchant onboarding, payout features, and dashboard. You can create a Cybersource integration using the [Finix Dashboard](#creating-a-cybersource-integration-using-the-dashboard) or [API](#creating-a-cybersource-integration-using-the-api). Merchants must use a Finix-issued Cybersource account. Existing Cybersource accounts cannot be used, and a new Cybersource account will need to be created with Finix. ## Prerequisites To enable Cybersource for a Finix merchant, create a Gateway Integration [after the merchant is successfully onboarded](/guides/platform-payments/onboarding-sellers/seller-onboarding-process). ## Creating a Cybersource Integration using the Dashboard You can create a Cybersource integration using the Finix Dashboard. Direct Merchants 1. In the Finix Dashboard, click **Company**. 2. Click the **Integrations** tab. - Your Cybersource integration status is displayed here. If Cybersource is not enabled, the status shows **Not Connected**. 3. Click **Set Up** to begin the Cybersource integration. Cybersource Integration - Direct Merchant Software Platforms 1. In the Finix Dashboard, go to **Merchants** and select the merchant you want to enable Cybersource for. 2. Click the **Account Settings** tab › **Integrations** tab. - The merchant’s Cybersource integration status is displayed here. If Cybersource is not enabled, the status shows **Not Connected**. 3. Click **Set Up** to begin the Cybersource integration. Cybersource Integration - ISV 1. You will be prompted to enter an email address. - To have the Cybersource invitation sent to a *different email* than the one listed on the merchant's `Identity` › `email`, you can enter the desired email here. Otherwise, the invitation will be sent to the pre-populated address. - Click **Next** to send the email invitation to set up your Cybersource dashboard and retrieve your production Transacting ID. See [Invitation Email](#setting-up-cybersource) for next steps. 2. Click **Done** to activate Cybersource as a Gateway Integration and return to the Finix Dashboard. ## Setting Up Cybersource After the `Gateway Integration` is created, Cybersource sends an email invitation. You will be prompted to confirm the Organization ID from your invitation email and email address. Click **Submit** to continue the onboarding process. Cybersource Sign Up This email allows the merchant to: - Activate their Cybersource account. - Create login credentials. - Access the CyberSource dashboard. - Obtain a Transacting ID to create transactions. Accept the invitation within 24 hours. If it expires, contact Finix Support to request a new invitation from Cybersource. Invitation Expiration Not accepting the Cybersource email invitation will cause onboarding delays. ## Locating Cybersource Transactions Once Cybersource is enabled, transactions processed through Cybersource can be viewed in two locations: - **Finix**: Transfers are visible via the Finix API and dashboard. - **Cybersource**: Transactions are visible in the Cybersource dashboard. Transaction identifiers can be used to reconcile records between Finix and Cybersource. Cybersource allows end users to view transactions only after 24 hours from their creation. ### Locating Cybersource Transactions in the Finix Dashboard To check if a transaction was processed by Cybersource, open the Finix Dashboard, go to **Transactions**, click **Payments**, and select the transaction. You can confirm the transaction was processed by Cybersource by checking the Integration Field. Check the **Integration** field in the **Payment Details** section. If Cybersource processed the transaction, the field will display `Cybersource`. Cybersource Integration Field ### Locating Transactions in Cybersource Dashboard In order to locate a transaction in the Cybersource dashboard, you must first copy the Cybersource transaction's `external_trace_id` from the Finix Dashboard. #### 1. Copy the External Trace ID from the Finix Dashboard If you are on the payment details page of a Cybersource payment in the Finix Dashboard, skip to the next step. Otherwise, open the Finix Dashboard, go to **Transactions** › **Payments**, and select the transaction. #### Option 1: Copy the External Trace ID from the Detail Page Copy the `external_trace_id` value by hovering over `External Trace ID`. View API Response #### Option 2: Copy the External Trace ID from API Response Click **View API Response** to view the payment's API response. View API Response Copy the `external_trace_id` value from the API response. Cybersource External Trace ID API Response #### 2. Locate the Transaction in the Cybersource Dashboard 1. Expand **Transaction Management** in the left-hand menu. 2. In the **Quick Search** form field, input the External Trace ID copied from the Finix Dashboard and update the **Date Range** accordingly. 3. Click **Search** to view the transaction details. ## Voiding a Cybersource Transaction To void a Cybersource authorization, perform an authorization reversal directly in the Cybersource Dashboard. 1. [Locate the transaction in the Cybersource Dashboard](#locating-transactions-in-cybersource-dashboard). 2. On the **Transaction Details** page, click **Authorization reversal**. 3. Confirm the authorization reversal when prompted. ## Creating a Cybersource Integration using the API In addition to the [Dashboard](#creating-a-cybersource-integration-using-the-dashboard) method, you can also create a Cybersource integration using the Finix API. ### 1. Create a Gateway Integration After [onboarding a merchant](/guides/platform-payments/onboarding-sellers/seller-onboarding-via-api), [create a Gateway Integration](/api/gateway-integrations/creategatewayintegration) to send an onboarding request to Cybersource. Provide the email address to receive the Cybersource dashboard invitation, which allows you to retrieve your Cybersource transacting credentials. Example API Definition A successful request returns a `201 Created` status code, with the response body containing the newly created `Gateway Integration` resource with a `state: PENDING`: Example Gateway Integration ```json Gateway Integration { "id": "gateway_integration_TBamsYxqr1KSnT4U2x9SP", "created_at": "2024-08-16T13:11:36.72Z", "updated_at": "2024-08-16T13:11:36.72Z", "application_id": "APgPDQrLD52TYvqazjHJJchM", "linked_to": "MUeg77opgdgQpwejzC9wCNmK", "linked_type": "MERCHANT", "email": "michael@finix.com", "state": "PENDING", // [!code highlight] "type": "CYBERSOURCE", "tags": { "gateway_name": "shopify" }, "_links": { "self": { "href": "https://api.sandbox-finix.com/v1/gateway_integrations/gateway_integration_TBamsYxqr1KSnT4U2x9SP" } } } ``` API Definition The `Gateway Integration` remains in a pending state (i.e., `Gateway Integration` › `state` is `PENDING`) until Cybersource approves the `Merchant`, after which the `state` changes to `SUCCEEDED`. If there are issues with the onboarding request, the state changes to `FAILED`, and Finix Support will contact you to update any required information. Finix will [send a webhook event](/additional-resources/developers/webhooks/webhook-events#gateway-integration-updated) and update the dashboard whenever the state changes. ### 2. Accept the Cybersource Email Invitation After the `Gateway Integration` is created, Cybersource sends an email invitation to the address provided in the request. See [Cybersource Email Invitation](#setting-up-cybersource) for next steps.