Tag: cybersource

Posted on by — Leave a comment

Cybersource Unified Checkout – Plugin Settings Documentation

This page explains each configuration option available for the WooCommerce – Cybersource Unified Checkout payment gateway. Follow these guidelines to ensure correct setup and a smooth checkout experience.

🔐 Enable/Disable

Enable Cybersource Unified Checkout
✔ Turns on the Cybersource payment gateway in WooCommerce.

🏷️ Title

Text displayed to customers at checkout as the payment method name.
Example: “Credit/Debit Card (Cybersource)”

✏️ Description

A short message shown under the payment method title during checkout.
Example: “Pay securely via Cybersource.”

🌎 Environment

Choose which Cybersource environment to connect to:

  • Test (sandbox) — for testing payments
  • Live (production) — for real transactions

Make sure keys match the selected environment.

🆔 Merchant ID (MID)

Your Cybersource Merchant ID as set in the Business Center.
Usually the same ID used to sign into Cybersource.

🗝️ REST API Key ID

Found inside Cybersource Business Center:
Payment Configuration → Key Management → REST API Keys

🔑 REST Shared Secret

Generated together with the API Key ID.
Used for creating secure requests to Cybersource.

🌍 Merchant Country

Select the country where your business is located.
Impacts allowed card networks and fraud tools.

🗣️ Locale

Language used in the payment UI.
Default: English (United States)

🧾 Billing Type Screen

Controls whether the payment UI collects:

  • Full → Billing + Payment info
  • Payment Only → Only card details (uses WooCommerce billing form)

Full is recommended to match Cybersource validation rules.

🚚 Request Shipping

Enable if you want Cybersource to collect shipping info from customer.

Options:

  • Yes
  • No (WooCommerce handles shipping instead)

🌏 Ship To Countries

Control which countries are allowed for shipping during checkout.
Use All countries or your preferred list.

💳 Allowed Card Networks

Select which card types customers can use:

  • Visa
  • Mastercard
  • American Express
  • Discover

💸 Allowed Payment Types

Toggle additional wallet methods:

  • Click to Pay
  • Apple Pay
  • Google Pay

(Requires Cybersource approval + correct domain validation)

🔄 Payment Action

Controls when the customer’s card is charged:

  • Authorize only → funds reserved, capture later
  • Authorize & Capture → charge immediately

For subscription or manual order approval → Use “Authorize only”

🧱 WooCommerce Blocks Checkout

Enable support for WooCommerce Checkout Blocks interface.
If disabled, only Classic Checkout form will be supported.

🧮 Line Items

When enabled, plugin sends detailed product and tax breakdown to Cybersource:

  • Product items
  • Shipping
  • Discounts
  • Taxes

Required for Level II / Level III processing compliance.

🏷️ Commodity Code (Optional)

Merchant-defined commodity code for Level II/III compliance
Example: 00000000 for general retail

📐 Unit of Measure (Optional)

Applies standardized UOM like:

  • EA (Each)
  • KG (Kilogram)
  • L (Liter)

Used in B2B / commercial billing

🐞 Debug Mode / Logging

Enable if troubleshooting gateway issues:

  • Stores detailed API logs in:
    WooCommerce ➜ Status ➜ Logs ➜ cybersource_uc-*

Disable when not needed to reduce log storage.

✅ Recommended Minimum Required Settings

FieldRecommended Value
EnvironmentLive once approved
Merchant ID / API KeysValid matching set
Allowed CardsVisa + Mastercard (minimum)
Line ItemsEnabled
Payment ActionAuthorize & Capture (unless special workflow)

👉 Additional Notes

✔ Make sure your server supports TLS 1.2+
✔ Domains must be verified for Apple Pay / Google Pay
✔ Refunds and captures can be done inside WooCommerce order screen

Posted on by — Leave a comment

How to Install Cybersource Unified Checkout Payment Gateway Plugin

WooCommerce – Cybersource Unified Checkout Installation Guide

Follow the steps below to install and configure the Cybersource Unified Checkout plugin on your WooCommerce store.

✅ Requirements

ComponentMinimum Requirement
WordPressv6.0 or higher
WooCommercev7.0 or higher
PHPv7.4 or higher (8.0+ recommended)
cURLEnabled
TLS1.2 or later
Cybersource AccountBusiness Center Access

Apple Pay & Google Pay may require additional domain validation.

Download first the CyberSource Unified Checkout plugin in your Patreon Dashboard

https://www.patreon.com/posts/cybersource-142294052

Step-by-Step Installation

1️⃣ Install via WordPress Dashboard

  1. Log in to WordPress Admin
  2. Go to Plugins → Add New
  3. Click Upload Plugin
  4. Choose the plugin ZIP file
  5. Click Install Now
  6. Click Activate

2️⃣ Enable WooCommerce Payments Gateway

  1. Go to WooCommerce → Settings → Payments
  2. Find Cybersource Unified Checkout
  3. Toggle Enable

You can now configure settings.

🔐 Creating API Keys in Cybersource

To complete setup, you must generate REST API Keys:

  1. Go to Cybersource Business Center
  2. Navigate to: Payment Configuration → Key Management
  3. Click Create Key
  4. Select:
    • Type: REST – Shared Secret
    • Merchant ID: Your MID
  5. Copy:
    ✅ API Key ID
    ✅ Shared Secret Key
    ✅ Organization ID (automatically included)

Store these securely.

⚙️ Plugin Configuration

Inside WordPress:

1️⃣ Go to WooCommerce → Settings → Payments → Cybersource Unified Checkout
2️⃣ Fill in:

FieldWhere to Find
Merchant IDCybersource Dashboard → Profile
REST API Key IDKey Management
Shared SecretKey Management
EnvironmentTest or Live dashboard

3️⃣ Adjust:

  • Allowed card networks
  • Payment action (Authorize vs. Authorize & Capture)
  • Address/Shipping collection

4️⃣ Save Changes

🧪 Testing Transactions

Before going live:

  1. Ensure Environment = Test
  2. Use Cybersource test cards:
    Cybersource → Developer Center → Testing Guide
  3. Place real cart orders on checkout page
  4. Check API logs if needed: WooCommerce → Status → Logs → cybersource_uc-*

✅ Make sure:

  • Customer info collects correctly
  • Order moves to Processing (if Capture)
  • Refunds/voids work inside WooCommerce

🚀 Going Live

When approved by Cybersource:

  1. Switch Environment → Live
  2. Replace API keys with Live credentials
  3. Confirm card payments are enabled in your account
  4. Place a small real order to verify live gateway

🎯 You are now fully live and ready to accept secure payments!

Posted on by — Leave a comment

CyberSource Secure Acceptance: Generate Access and Secret Keys

The Access Key and Secret Key are essential credentials required for authenticating and securing transactions through CyberSource’s Secure Acceptance integration.

✅ Prerequisites

Before proceeding, ensure you have:

  • Access to the CyberSource Business Center.
  • The necessary permissions to view or manage Secure Acceptance profiles.
  • An existing Secure Acceptance Profile. If you haven’t created one yet, refer to the guide on creating a Secure Acceptance profile.

🧭 Step-by-Step Guide

  1. Log in to CyberSource Business Center:
  2. Navigate to Secure Acceptance Settings:
    • In the left-hand menu, click on Payment Configuration.
    • Select Secure Acceptance Settings from the dropdown.
  3. Access Your Profile:
    • Under Active Profiles, locate the profile for which you need the keys.
    • Click on the profile name to open its settings.
  4. Generate Security Keys:
    • Navigate to the Security tab within your profile.
    • Click on Create Key.
    • Fill in the following details:
      • Key Name: Enter a descriptive name for the key.
      • Signature Version: Select 1.
      • Signature Method: Choose HMAC-SHA256.
      • Security Profile: Select the appropriate profile.
    • Click Generate Key
  5. Retrieve and Store Your Keys:
    • Once the keys are generated, you will see the Access Key and Secret Key displayed.
    • You can:
      • Copy the keys to your clipboard.
      • Download the keys as a .txt file for safekeeping.

Note: These keys are essential for authenticating transactions. Store them securely and do not share them publicly.

📌 Additional Recommendations

  • Security: Regularly rotate your security keys and monitor transactions for any suspicious activity.
  • Environment Separation: Maintain separate profiles and credentials for test and production environments to prevent accidental cross-environment transactions.
  • Documentation: Refer to the Secure Acceptance Hosted Checkout Integration Guide for detailed information on integrating and configuring your Secure Acceptance profile.

If you need further assistance or have specific questions about the integration process, feel free to ask!

Posted on by — Leave a comment

How to Locate Your CyberSource Secure Acceptance Profile ID

The Profile ID is a unique identifier assigned to each Secure Acceptance profile within your CyberSource Business Center account. This ID is essential for integrating CyberSource’s payment processing services into your application or website.

✅ Prerequisites

Before proceeding, ensure you have:

  • Access to the CyberSource Business Center.
  • The necessary permissions to view or manage Secure Acceptance profiles.

🧭 Step-by-Step Guide

Log in to CyberSource Business Center:

Navigate to Secure Acceptance Settings:

  • In the left-hand menu, click on Payment Configuration.
  • Select Secure Acceptance Settings from the dropdown.

Access Your Profile:

  • Under Active Profiles, locate the profile for which you need the Profile ID.
  • Click on the profile name to open its settings.

Locate the Profile ID:

  • On the profile’s General Settings page, you’ll find the Profile ID displayed near the top.
  • The Profile ID is typically a 36-character string formatted like: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX .

🔐 Additional Credentials

For a complete integration, you may also need the following credentials:

  • Access Key:
    • Navigate to the Security tab within your profile.
    • Here, you’ll find the Access Key associated with your profile.
  • Secret Key:
    • In the same Security tab, click on View Key to reveal the Secret Key.
    • Ensure you store this key securely, as it’s used for signing transaction data.

Note: Both the Access Key and Secret Key are essential for authenticating and securing transactions through the Secure Acceptance integration.developer.cybersource.com

📌 Tips

  • Security: Always store your credentials securely and avoid sharing them publicly.
  • Environment Separation: Maintain separate profiles and credentials for test and production environments to prevent accidental cross-environment transactions.
  • Documentation: Refer to the Secure Acceptance Hosted Checkout Integration Guide for detailed information on integrating and configuring your Secure Acceptance profile.

Image Guide

Posted on by — Leave a comment

How to Create a CyberSource Secure Acceptance Profile

✅ Prerequisites

Before you begin, ensure you have:

  • A CyberSource Business Center account (either Test or Production).
  • The necessary permissions to create profiles and generate security keys.

🧭 Step 1: Access Secure Acceptance Settings

  1. Log in to your CyberSource Business Center:
  2. Navigate to Payment Configuration > Secure Acceptance Settings.

📝 Step 2: Create a New Profile

  1. Click on New Profile.
  2. Fill in the required fields:
    • Profile Name: A unique name (max 20 alphanumeric characters).
    • Profile Description: Optional, up to 255 characters.
    • Integration Method: Select Hosted Checkout.
    • Added Value Services: Enable as needed (e.g., Decision Manager, Payment Tokenization).
  3. Click Save to proceed

💳 Step 3: Configure Payment Settings

  1. Within your new profile, go to the Payment Settings tab.
  2. Select the card types you wish to accept (e.g., Visa, MasterCard).
  3. For each card type:
    • Click on the settings icon.
    • Specify the supported currencies.
  4. Click Save to apply the settings

🔐 Step 4: Generate Security Keys

  1. Navigate to the Security tab within your profile.
  2. Click on Create Key.
  3. Fill in the following details:
    • Key Name: A descriptive name for the key.
    • Signature Version: Select 1.
    • Signature Method: Choose HMAC-SHA256.
    • Security Profile: Select the appropriate profile.
  4. Click Generate Key.
  5. Once generated, either:
    • Copy the Access Key and Secret Key to a secure location.
    • Download the keys as a .txt file for safekeeping.

Note: These keys are essential for authenticating transactions. Store them securely and do not share them publicly.

🔁 Step 5: Set Up Customer Response URLs

  1. Go to the Customer Response tab.
  2. In the Custom Redirect After Checkout section:
    • Transaction Response Page: Enter the URL where customers should be redirected after a successful transaction.
    • Cancel Response Page: Enter the URL for redirection if a customer cancels the transaction.
  3. Click Save to apply the changes.

🚀 Step 6: Activate the Profile

  1. Return to the main profile page.
  2. Click on Promote Profile to activate it.
  3. Confirm the promotion when prompted.

Important: Once promoted, the profile becomes active and ready for transaction processing.

📌 Additional Recommendations

  • Testing: Before going live, thoroughly test the integration using the Test Environment to ensure all configurations work as expected.
  • Documentation: Refer to the Secure Acceptance Hosted Checkout Integration Guide for in-depth information.
  • Security: Regularly rotate your security keys and monitor transactions for any suspicious activity.

For a visual walkthrough, you might find this tutorial helpful:

Posted on by — Leave a comment

How to Install CyberSource Payment Gateway Plugin

Step 1. Download the CyberSource plugin in your Codecanyon Dashboard

Step 2. Extract the file zip archive in your computer

Step 3. Install your CyberSource plugin in WordPress

Goto in your WordPress admin dashboard menu plugins > Add New

Next Add Plugins using Upload Plugin button

Upload the CyberSource plugin zip file

Activate the CyberSource plugin