Supported Functionality

Feature	Supported
Authorization	✅
Capture	✅
Refund	✅
Void	✅
Card Tokenization	✅
Dynamic Merchant Descriptors	❌
3D Secure	❌
$0 Transactions	✅

Setup

To connect a Merchant using the Ecrypt Gateway,

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

Gateway Details	Description
Private API Key*	The private API key from the Ecrypt dashboard under Settings > API/Security Keys. Ecrypt does not use a separate sandbox address — whether the key is a test or production key determines which environment the transaction is processed in.
Use Preferred Payments endpoint	Ecrypt is also sold as Preferred Payments. Check this box to send requests to `api.preferredpayments.com` instead of `api.ecrypt.com`. Both addresses serve the same API — use whichever the merchant was boarded on.
Store cards in the Ecrypt vault	Check this box to store the card with Ecrypt after the first approved transaction. Renewals will then charge the stored card instead of resending the card details.
Bypass $0 Transaction Authorizations	Ecrypt cannot charge $0.00, so it has a validation endpoint instead. When unchecked, Vrio validates the card through that endpoint and the result determines whether the transaction is successful — unlike gateways that require a $1 authorization and immediate reversal, no charge is ever placed against the card. Check this box to bypass the gateway entirely for $0 transactions; the card is not validated when this is checked. Learn more about $0.00 transaction handling.
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

*Required

Supported Payment Methods

Credit Card

Card Tokenization

When Store cards in the Ecrypt vault is checked, charges made with card data ask Ecrypt to save the card. Vrio stores the returned vault id and reuses it for every renewal.

Dynamic Merchant Descriptors

Vrio does not send a descriptor to Ecrypt with the charge, so the customer's statement shows whatever is configured on your Ecrypt account.

3D Secure

Ecrypt does not accept 3D Secure authentication data. Authentication values passed with an order are not sent to the gateway.

Testing

Note : Placing test orders using Ecrypt 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 Ecrypt test cards, check here.