The Transaction Modification API feature makes it possible to remotely edit the affiliate's payout, merchant's revenue, and/or the transaction approval status. You can also grant access to a merchant and allow them to edit their own transactions.
Because you are using a feature that is outside the secure environment of the LinkTrust app, LinkTrust has enhanced the layers of security for this feature. That means that you must enable external transaction modification for each campaign separately and provide a custom password. You can also restrict changes to come from only specific white listed IP addresses.
NOTE: LinkTrust highly recommends using HTTPS for all transaction edit API calls to ensure secure communications. This requires your inbound URL to be configured for HTTPS. You must have a secure certificate setup with LinkTrust to do this.
To adjust a transaction, you need the updated affiliate payout, merchant revenue, or approval status with a valid click ID, transaction ID or a combination of merchant reference ID and campaign ID with the security password. The ability to use the merchant reference ID and campaign ID combination requires you to enforce a unique merchant reference ID for each transaction in the campaign settings.
Merchants can also modify transactions within LinkTrust by passing their own ID from their back office CRM or shopping cart instead of needing to record and use LinkTrust identifiers.
In this help page, you learn the following:
To enable external transaction modifications, do the following:
If you plan to use the white list, make sure you add the IP address to the white list. The white list is located under Account > Domains.
The posting URL used for all transaction modification is the following:
You must have one of the following three parameters to modify these transactions:
NOTE: Only one method can be used at a time per transaction.
After the transaction is located, you can modify the transaction in the following ways:
For added security, the password you placed in LinkTrust when enabling the transaction modification feature must be passed in for each modification. Use the following parameter:
To modify a transaction externally, you must have one of the following URLs to perform this action:
As you can see, each modification URL has all of the following four components:
There is no required order for these name-value pairs when posting in a modification.
When a transaction modification is done from an external source, LinkTrust responds with the following server responses:
Sample Success Response:
<?xml version="1.0" encoding="UTF-8"?>
Sample Failure Response:
<?xml version="1.0" encoding="UTF-8"?>
<Message>Permanent Failure: Invalid authentication credentials.</Message>
The following table lists possible error messages and their results:
Using a text file allows you to modify a large quantity of transactions quickly. For example, you want to unapprove 150 transactions given to you by your merchant and you do not want to make these changes one by one. After understanding the information needed to make these changes remotely, you can create a spreadsheet in Excel and then have the lead poster post these modifications for you.
The tab delimited (*.TXT) file format is a format used to store table data where numbers and text are stored in plain textual form that can be read in a text editor. You must first create a spreadsheet and save it as a TXT file for the creative import to work. For your convenience, download the sample .CSV files to get started.
To create a spreadsheet file, do the following:
1. Download the sample spreadsheet file. Note: The downloadable file is compressed for easier downloading.
2. Save the file to your desktop.
3. Open the file in Excel.
4. Make the following column headers using one of the following methods:
5. Import the appropriate transaction modification information.
6. When you are finished, save the file into a Tab Delimited (*.TXT) File.
7. Select Save as.
8. Select Other Formats.
9. Select Text (Tab Delimited).
10. Import a Tab Delimited (*.TXT) File.
Now that your file is complete, you are ready to use the lead poster to modify your transactions. You must use the GET method in the lead poster to post the modifications into the system. To learn more, select lead poster.