PayPal is a digital wallet to give customers more options when choosing how to pay.

Supported Functionality

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

Setup

Each PayPal account is treated as a Merchant Account within Vrio

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

Gateway Details	Description
Name	Internal name to reference
Post Back Tracking	Check this box if you would like Vrio to pass back tracking numbers to Paypal when a shipment is shipped and a tracking number is collected
Sandbox	Check this box to connect the merchant to PayPal's sandbox environment for testing. When you are redirected, sign in with your PayPal developer account rather than a live account.
Bypass $0 Transaction Authorizations	Check this box to bypass PayPal entirely for $0 credit card transactions — the card will not be validated or stored. When unchecked, a $1 authorization (voided immediately) will be used to validate and store the card for future use. PayPal wallet payments will continue to process normally. This setting only applies to initial transactions — $0 renewals will always bypass the gateway. Learn more about $0.00 transaction handling.
Merchant Payment Methods*	The types of payment methods this merchant accepts — credit card and PayPal. Credit Card - Accepts card information and utilizes PayPal as just a gateway PayPal - This will take customers to their PayPal account. If posting orders through the Vrio API, please follow this recipe.
Merchant Card Types*	Card types to be accepted on this Merchant. Only applicable if Credit Card is a Payment Method accepted.
Merchant Default Currency*	Default currency that will be used, if currency is not specified
Merchant Currencies*	All currencies accepted on this merchant

Once you hit submit, you will be taken to PayPal to complete the setup.

Supported Payment Methods

Credit Card
PayPal

Card Tokenization

When vaulting is enabled on the merchant, PayPal saves the payer's method on a successful order. Vrio stores the returned vault id and reuses it for every renewal.

Dynamic Merchant Descriptors

Vrio does not send a descriptor to PayPal with the charge.

3D Secure

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

Activating PayPal

If you are using PayPal in addition to any other Merchant Gateway, you will want to add the PayPal merchant to a Payment Router.

Learn more here.

PayPal Order Processing

Create and process a PayPal order after already collecting all customer billing and shipping information.

See the recipe here.

Headless Express PayPal

Use the Vrio API to offer Express PayPal on your headless site. This method will allow you create a token in order to gather all the customers information such as shipping and billing

See the recipe here

Testing

To test PayPal, first create a developer account with PayPal. Then add a new PayPal merchant in Vrio and check the Sandbox box. When you are redirected, sign in with your developer account.

Note : Placing test orders with a PayPal sandbox account or using PayPal 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 PayPal test cards, check here.