--- title: Transaction Modification API description: 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 --- [Skip to content](https://help.linktrust.com/en/knowledge/transaction-modification-api#main-content) English Show submenu for translations [Customer portal](https://help.linktrust.com/portal?hsLang=en) ![lt-logo.png\]](https://help.linktrust.com/hs-fs/hubfs/lt-logo.png?height=40&name=lt-logo.png) Open main navigation Close main navigation - English Show submenu for translations - [Customer portal](https://help.linktrust.com/portal) - Contact us Contact us Hi, Welcome to the LinkTrust Help Center. - There are no suggestions because the search field is empty. 1. [Help Center](https://help.linktrust.com/en/knowledge?hsLang=en) 2. [API's](https://help.linktrust.com/en/knowledge/apis?hsLang=en) 3. [Version 2 - Partner](https://help.linktrust.com/en/knowledge/apis?hsLang=en#version-2-partner) # Transaction Modification API 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: - Enable External Transaction Modifications - Identify Posting Parameters - Identify Posting Transaction Server Responses - Identify Error Response Messages - Create a Tab Delimited (\*.TXT) File - Use Lead Poster ### Enable External Transaction Modifications To enable external transaction modifications, do the following: 1. From the menu, select Campaigns \> **View All**. 2. Browse to and select the **campaign** you wish to enable external transaction modifications for. 3. Open the campaign settings by selecting the **Edit Campaign** icon. 4. Under Tracking Options, mark **Allow External Transaction Modifications**. 5. In the Custom Password field, enter a **password**. 6. If you want these externally modified transactions to ONLY come from a known IP address, select **Only Allow Modifications from White Listed IPs**. 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. ### Identify Posting Parameters The posting URL used for all transaction modification is the following: http://\[*TrackingURL*.com\]/transaction.edit You must have one of the following three parameters to modify these transactions: 1. LinkTrust transaction ID (Transactionid=*value*) 2. Click ID (Clickid=*value*) 3. Merchant reference ID and campaign ID (Merchantreferenceid=*value*&CID=*xxxxxxx*) **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: 1. **Affiliate Payou**t (AP=*0.00*) 2. **Merchant Payout** (MP=*0.00*) 3. Transaction **Approval** status (A=yes or A=no) (Yes is for an approved transaction and No is for an unapproved transaction.) 4. **Execute** **the Affiliate's Server Side Post Back URL** (executeaffiliatepixel=Yes) 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: Password (Password=*value*) ### Sample Transaction Modification URLs To modify a transaction externally, you must have one of the following URLs to perform this action: - Transaction ID URL: http://\[TrackingURL.com\]/transaction.edit?Password=value&Transactionid=value&A=no&AP=0.00&MP=0.00&executeaffiliatepixel=Yes - Click ID URL: http://\[TrackingURL.com\]/transaction.edit?Password=value&ClickID=value&A=no&AP=0.00&MP=0.00&executeaffiliatepixel=Yes - Merchant Reference ID and Campaign ID URL: http://\[TrackingURL.com\]/transaction.edit?Password=value&Merchantreferenceid=value&CID=xxxxxx&A=no&AP=0.00&MP=0.00&executeaffiliatepixel=Yes When using the Merchant Reference ID, you must have the following campaign filter enabled before the conversion occurred: *Do not track transactions with Duplicate Merchant Reference IDs within the last 90 days (Makes Merchant Reference ID required)* As you can see, each modification URL has all of the following four components: 1. Posting URL 2. Password 3. Identifier 4. Modification parameters There is no required order for these name-value pairs when posting in a modification. ### Transaction Modification Server Responses When a transaction modification is done from an external source, LinkTrust responds with the following server responses: **Sample Success Response:** \ \\ \True\ \ \\ \\ \\ \\ \0.00\ \0.00\ \no\ \\ \ \\ **Sample Failure Response:** \ \\ \False\ \\permanent\ \Permanent Failure: Invalid authentication credentials.\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \ \\ ### Identify Error Response Messages The following table lists possible error messages and their results: ![Transaction\_API\_Errors](https://help.linktrust.com/hubfs/Transaction_API_Errors.png)   ### Create a Tab Delimited (\*.TXT) File 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](https://help.linktrust.com/knowledge/linktrust-lead-poster?hsLang=en) 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.](https://docs.google.com/spreadsheets/d/1rRVugvqi73GeshDmFVXz7vHPELWvhzXTkx4qtCDoFn4/export?format=xlsx) **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: - **Transaction ID Method** - *Password* - *TransactionID* - *AP* - *MP* - *A* - executeaffiliatepixel - **Click ID Method** - *Password* - *ClickID* - *AP* - *MP* - *A* - executeaffiliatepixel - **Merchant Reference ID + Campaign ID Method** - *Password* - *MerchantreferenceID* - *CID* - *AP* - *MP* - *A* - *executeaffiliatepixel*   **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. ### Use Lead Poster 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.](https://help.linktrust.com/knowledge/linktrust-lead-poster?hsLang=en)   You can[request a demo](https://linktrust.com/request-demo/) to see LinkTrust up close and experience how it can help you, or[start your free 14-day trial](https://linktrust.com/free-trial/) now. Need help with this feature or have questions? You can contact our support team at [support@linktrust.com](mailto:support@linktrust.com) - [Advertiser Center](https://help.linktrust.com/en/knowledge/advertiser-center?hsLang=en) - [Affiliate Center](https://help.linktrust.com/en/knowledge/affiliate-center?hsLang=en) - [Affiliate Settings](https://help.linktrust.com/en/knowledge/affiliate-settings?hsLang=en) - [API's](https://help.linktrust.com/en/knowledge/apis?hsLang=en#main-content) - [API v1 Framework](https://help.linktrust.com/en/knowledge/apis?hsLang=en#api-v1-framework) - [Version 2 - Affiliate](https://help.linktrust.com/en/knowledge/apis?hsLang=en#version-2-affiliate) - [Version 2 - Partner](https://help.linktrust.com/en/knowledge/apis?hsLang=en#version-2-partner) - [Campaign Settings](https://help.linktrust.com/en/knowledge/campaign-settings?hsLang=en#main-content) - [Advertise - Affiliates](https://help.linktrust.com/en/knowledge/campaign-settings?hsLang=en#advertise-affiliates) - [FAQs](https://help.linktrust.com/en/knowledge/faqs?hsLang=en#main-content) - [Pixel/Conversion Tracking](https://help.linktrust.com/en/knowledge/faqs?hsLang=en#pixel-conversion-tracking) - [Affiliates](https://help.linktrust.com/en/knowledge/faqs?hsLang=en#affiliates) - [Getting Started](https://help.linktrust.com/en/knowledge/faqs?hsLang=en#getting-started) - [General Questions](https://help.linktrust.com/en/knowledge/faqs?hsLang=en#general-questions) - [Lead Gen](https://help.linktrust.com/en/knowledge/lead-gen?hsLang=en) - [MarketPlace](https://help.linktrust.com/en/knowledge/marketplace?hsLang=en#main-content) - [Shopping for Offers](https://help.linktrust.com/en/knowledge/marketplace?hsLang=en#shopping-for-offers) - [Partner (Admin) Center](https://help.linktrust.com/en/knowledge/partner-admin-center?hsLang=en) - [Reporting](https://help.linktrust.com/en/knowledge/reporting?hsLang=en) - [Tokens](https://help.linktrust.com/en/knowledge/tokens?hsLang=en) - [Videos](https://help.linktrust.com/en/knowledge/videos?hsLang=en#main-content) - [Features](https://help.linktrust.com/en/knowledge/videos?hsLang=en#features) - [Lead Generation](https://help.linktrust.com/en/knowledge/videos?hsLang=en#lead-generation) - [Product Updates](https://help.linktrust.com/en/knowledge/videos?hsLang=en#product-updates) - [What's New?](https://help.linktrust.com/en/knowledge/whats-new?hsLang=en#main-content) - [2022](https://help.linktrust.com/en/knowledge/whats-new?hsLang=en#2022) - [2023](https://help.linktrust.com/en/knowledge/whats-new?hsLang=en#2023) - [3rd Party Integrations](https://help.linktrust.com/en/knowledge/3rd-party-integrations?hsLang=en#main-content) - [Affiliate Payment](https://help.linktrust.com/en/knowledge/3rd-party-integrations?hsLang=en#affiliate-payment) - [Email Compliance](https://help.linktrust.com/en/knowledge/3rd-party-integrations?hsLang=en#email-compliance) - [Fraud Prevention Tools](https://help.linktrust.com/en/knowledge/3rd-party-integrations?hsLang=en#fraud-prevention-tools) - [Offer Listing](https://help.linktrust.com/en/knowledge/3rd-party-integrations?hsLang=en#offer-listing) - [Pay-Per-Call](https://help.linktrust.com/en/knowledge/3rd-party-integrations?hsLang=en#pay-per-call) - [TrackDrive](https://help.linktrust.com/en/knowledge/3rd-party-integrations?hsLang=en#trackdrive) - [Stripe](https://help.linktrust.com/en/knowledge/3rd-party-integrations?hsLang=en#stripe) - [eCommerce](https://help.linktrust.com/en/knowledge/3rd-party-integrations?hsLang=en#ecommerce) # linktrust.com Help Center Copyright © 2026, linktrust.com