SecondSwype

SecondSwype recovery gateway for declined transaction salvage, configured as a dunning attempt merchant for reattempt processing only.

SecondSwype is a decline recovery gateway. It never originates a sale of its own — Vrio only ever hands it a transaction that has already been declined somewhere else, and it makes a second attempt at approving it.

That shapes where it fits. A SecondSwype merchant is not attached to a campaign and is not added to a payment router's available merchants, because neither of those is a decline. Instead you place it at one of the two points where Vrio already has a decline in hand:

  • A checkout decline — as the reattempt merchant on a router's initial decline reattempt, salvaging the sale while the customer is still in checkout.
  • A renewal decline — as the merchant on a single attempt of a dunning schedule, salvaging a failed subscription renewal.

Both are configured under Setup below.

Supported Functionality

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

Setup

To connect a Merchant using the SecondSwype Gateway,

  1. First add Merchant
  2. Select SecondSwype as the Gateway
  3. Add Gateway Details as outlined below
Gateway DetailsDescription
Security Key*Campaign security key provided by SecondSwype
Test ModeSends every transaction flagged as a test. SecondSwype has no separate sandbox host, so this is how you test against the live endpoint
Pass Merchant DescriptorPasses the merchant descriptor to SecondSwype with each transaction
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

The two places are configured independently, and the same SecondSwype merchant can serve either one or both.

Recovering an initial decline

Salvages a checkout decline while the customer is still in the checkout process.

  1. Add the SecondSwype merchant as above
  2. Open the router and go to the Advanced Routing tab
  3. Check Reattempt Initial Declined, then Reattempt on a specific Merchant
  4. Select the SecondSwype merchant

See Initial Decline Reattempts for the full set of reattempt options.

Recovering a renewal decline

Salvages a failed subscription renewal as one step of a dunning schedule.

  1. Add the SecondSwype merchant as above
  2. Open the dunning schedule you want to recover through and edit the attempt that should go to SecondSwype
  3. Set that attempt's Merchant to the SecondSwype merchant
  4. Leave Keep Merchant On Success unchecked — it is unavailable for recovery gateways, since a subscription can never keep billing on one

Any attempt that does not name a merchant continues on the merchant of the original attempt, so a subscription recovered through SecondSwype returns to its normal merchant on the next renewal.

Supported Payment Methods

Credit Card

Card Tokenization

SecondSwype does not store cards. Card data is sent on every charge, and the CVV is only sent on the first cycle.

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.

3D Secure

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

Testing

Note : Placing test orders with Test Mode enabled or using SecondSwype 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.

Reach out to SecondSwype for test card information.


Did this page help you?