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
| Field | Recommended Value |
|---|---|
| Environment | Live once approved |
| Merchant ID / API Keys | Valid matching set |
| Allowed Cards | Visa + Mastercard (minimum) |
| Line Items | Enabled |
| Payment Action | Authorize & 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