Supported Functionality

Feature	Supported
Authorization	✅
Capture	✅
Refund	✅
Void	✅
Card Tokenization	✅
Dynamic Merchant Descriptors	✅ Trimmed to 22 characters
3D Secure	✅ Pass your own
$0 Transactions	❌

Setup

To connect a Merchant using the Cybersource Gateway,

First add Merchant
Select Cybersource as the Gateway
Add Gateway Details as outlined below

Gateway Details	Description
Merchant ID*	provided by Cybersource
API Key*	provided by Cybersource
API Shared Secret Key*	provided by Cybersource
Merchant Payment Methods*	The types of payment methods this merchant accepts — credit card only.
Merchant Card Types*	Card types to be accepted on this Merchant
Merchant Default Currency*	Default currency that will be used, if currency is not specified
Merchant Currencies*	All currencies accepted on this merchant
Pass Merchant Descriptor	When checked, the merchant descriptor set on the Merchant Account is sent to Cybersource with the charge. See Dynamic Merchant Descriptors.
Bypass $0 Transaction Authorizations	Check this box to bypass card validation with Cybersource for $0 transactions. When unchecked, a $1 authorization (voided immediately) will be used to validate the card — the result of this authorization will determine if the transaction is successful. This setting only applies to initial transactions — $0 renewals will always bypass the gateway. Learn more about $0.00 transaction handling.

*Required

Supported Payment Methods

Credit Card

Card Tokenization

Charges made with card data ask Cybersource to save the card. Vrio stores the returned payment instrument and reuses it for every renewal.

Dynamic Merchant Descriptors

When Pass Merchant Descriptor is checked, Vrio sends the Merchant Account descriptor with every charge, or a merchant_descriptor passed when the order is processed, which is then reused for that order's renewals.
If the order later moves to a different merchant, that merchant's descriptor is used instead.
Cybersource accepts up to 22 characters and silently shortens anything longer.

3D Secure

Cybersource accepts 3D Secure authentication data that you generate with a third party provider. Values are sent whenever authentication data exists on the order for the cycle being charged.

Vrio	Cybersource
`order_eci`	`consumerAuthenticationInformation.eciRaw`
`order_cavv`	`consumerAuthenticationInformation.cavv`
`order_xid`	`consumerAuthenticationInformation.xid`
`order_3ds_ds_transaction_id`	`consumerAuthenticationInformation.directoryServerTransactionId`

See Third Party 3DS Providers for the full parameter reference.

Testing

Note : Placing test orders using Cybersource test cards will not automatically set the order as a test in Vrio. Be sure to flag the order as a test using the is_test flag after the order is processed. For more details on placing test orders, click here.

For Cybersource test cards, check here.