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










