Vindicia Subscribe Portal User Guide
- Vindicia Subscribe Portal User Guide Overview
Chargeback Reason Codes
Payment Capture Flows
Billing Notifications and Templates
Vindicia Subscribe Dashboard
Using the Vindicia Subscribe Portal
Vindicia Subscribe for Salesforce
PayPal One-Time and Recurring Transactions
The following diagram describes the Payment Capture Flow for a PayPal transaction.
Payment Capture Flow: PayPal Transactions
Both One-Time and (initial) Recurring Transactions using PayPal as a Payment Method step through the following process:
1. When your customer selects PayPal as their Payment Method, call Vindicia Subscribe to initiate the transaction, passing Vindicia Subscribe all relevant purchase information.
Initializing the process creates a Transaction, sets its status to AuthorizationPending, and begins the Checkout process with PayPal.
2. Vindicia Subscribe creates a new Transaction, and calls PayPal with SetExpressCheckout.
3. PayPal initiates the session, and returns a token, the PayPal redirect URL, and a reference ID (if requested) to Vindicia Subscribe.
Request a reference ID from PayPal only for use in recurring AutoBills. The reference ID is not used for One-Time Transactions.
4. Vindicia Subscribe then sets the Transaction status to Pending (or Failed), and redirects your customer to you with the PayPal token and redirect URL. (If PayPal returned a Failure, Vindicia Subscribe redirects your customer to your specified cancel URL.)
- On success, PayPal returns a unique session identifier, or “token,” and a redirect URL to Vindicia Subscribe, and Vindicia Subscribe passes that information back to the merchant for processing.
- On failure, PayPal returns a failure reason code to Vindicia Subscribe, and Vindicia Subscribe passes that information to you in a TransactionStatusPayPal object for processing.
5. Redirect your customer to the PayPal site, using the PayPal redirect URL returned from Vindicia Subscribe.
6. On the PayPal redirect URL, your customer enters their username and password, and clicks Continue. PayPal authenticates the user, and redirects them to the Payment Method selection page. Your customer selects their payment method, reviews the order, and clicks Approve (or Cancel).
- Invisible to the customer, the PayPal site momentarily redirects to Vindicia Subscribe.
- With a successfully completed PayPal transaction process, Vindicia Subscribe redirects the customer to the merchant’s success URL.
- On a failed or cancelled PayPal transaction process, Vindicia Subscribe redirects the customer to the merchant’s cancel URL.
7. Do the following:
- From your Success page, call Vindicia Subscribe to finalize the transaction.
- From your Cancel page, call Vindicia Subscribe to cancel the transaction.
8. Vindicia Subscribe sets the Transaction Status to Authorized, queues it for batch capture, and calls ExpressCheckout with the PayPal Token to complete the process.
Transactions are captured in batches (normally twice a day).
Using PayPal for recurring billing, your customer must participate directly in the initial product purchase, but subsequent billing cycles may be generated and handled automatically by Vindicia Subscribe and PayPal. During the initial purchase process, the customer must be “validated,” but for subsequent billings, the customer need not be validated again unless the AutoBill requires updating or the AutoBill expires.