Request Field Mapping

This page explains the most important request fields for Factoring Decline API v1.

Pre-assigned account values

API field	Source	Notes
`connection_id`	Fixed value	Always send `1`.
`campaign_id`	API Credentials page	Copy Vrio Campaign ID.
`offers[].offer_id`	API Credentials page	Copy one of the assigned Vrio Offer IDs.
`payment_method_id`	Fixed value	Always send `1` for credit card.
`action`	Fixed value	Always send `process`.

Tracking fields

API field	Value to send	Purpose
`tracking1`	Affiliate ID from the API Credentials page.	Identifies the merchant account.
`tracking2`	Your click ID or order reference.	Used to match postbacks to your original order.
`tracking3`	Original decline code.	Stores the upstream decline code.
`tracking4`	Original decline reason or message.	Stores the upstream decline reason.
`tracking5`	`4`	Product type marker for Factoring Decline v1.

Statement Descriptor

Statement Descriptor is configured separately in:

https://factoring.ltvx.dev/api-settings

Do not use tracking1 as the descriptor. tracking1 is the Affiliate ID from the API Credentials page.

Address fields

If same_address is true, the billing address is copied from the shipping address.

If same_address is false, send the billing fields such as bill_fname, bill_lname, bill_address1, bill_city, bill_zipcode, and bill_country.