Skip to main content

Search

Admoji Help Center

Browse guides, FAQs, and tutorials — or search for something specific

How to Set Up the LTVX Plugin

LTVX is a payment recovery service. When a new sale or upsell declines on a processor that has LTVX enabled, Admoji hands the order to LTVX, LTVX tries to collect the payment on its side, and the result comes back to Admoji. If the payment is recovered, it is recorded as a successful order automatically — you do not need to touch it.

You connect LTVX once from the Plugins Center and then choose which of your processors send their declines to it.

Note: You need an LTVX merchant account first. From the LTVX merchant portal, collect your API Key, Connection ID, Campaign ID, Route ID, and Offer ID before you start.

Step 1: Open the LTVX plugin

  1. Go to Administration > Plugins.

  2. Open the Tools tab.

  3. Find the LTVX card and open it. The Add LTVX page appears.

Tools tab of the Plugins Center with the LTVX card under Available Integrations

Step 2: Enter your LTVX credentials

Fill in the fields with the values from your LTVX merchant portal:

  • API Key — required. Your LTVX API key.

  • Connection ID — required.

  • Campaign ID — required.

  • Route ID — required.

  • Offer ID — required.

  • Tracking1 — optional. A free-text tracking value passed along with each order.

  • Sandbox Environment — turn on for testing. The API URL is the same either way; LTVX decides which environment to use based on the API key you provide.

Add LTVX page with the API Key, Connection ID, Campaign ID, Route ID, Offer ID, Tracking1 and Sandbox Environment fields
Note: The four ID fields only accept numbers and must be 1 or higher. The Save button stays disabled until every required field is valid and at least one processor is selected in Step 3.

Step 3: Choose which processors use LTVX

The Processors list at the bottom of the page controls where recovery applies. Only declines on the processors you tick are sent to LTVX.

  1. Tick the processors you want to enable. Each row shows the processor name and its ID.

  2. Click Select all to enable every processor at once.

  3. Click Save.

Processors list with a processor ticked and the Select all button
Note: If the page shows No processors available, there is nothing to enable yet and the plugin cannot be saved. Add a processor first.

How Recovery Works

  1. A sale or upsell declines on its last attempt — after the Base round and any Retry Rounds of its load balancer rule — and the processor that declined it has LTVX enabled. Admoji queues the order for recovery. Recurring charges are not sent to LTVX.

  2. Once a day, a background job sends the queued orders to LTVX. For each one it creates a new order for the customer with the same products and amounts; the declined order stays as it was. Orders that were already reprocessed are skipped, and orders from customers with no card on file cannot be sent.

  3. If LTVX resolves the attempt right away, the new order gets the result at once. Otherwise it stays pending until LTVX sends a postback to Admoji.

  4. If the payment is recovered, the new order is set to Success and a sale transaction is added to it, showing the LTVX transaction ID.

  5. If the recovery fails, the new order is set to Error with the reason returned by LTVX.

Tip: Every outcome is written to the customer’s Logs tab, including the LTVX order ID and transaction ID. Use it to confirm whether a specific decline was recovered.

Edit or Remove the Plugin

  1. Go back to Administration > Plugins > Tools and open LTVX. The page opens as Edit LTVX with your saved values.

  2. Change what you need and click Save, or click Delete to disconnect the integration.

Edit LTVX page with the Back, Delete and Save buttons
Important: Deleting the plugin also deactivates all LTVX processors, and the action cannot be undone.

Related articles