Setup to PayTrace - Trace AR for Acumatica

Setup to PayTrace - Trace AR for Acumatica

Step 1: Downloading the PayTrace Package

  1. In the search box at the top, type "Customization Projects" and open the screen.

    image-20250221-202220.png
  2. Use the "Import" button to upload the necessary .zip file containing the customization project.

    image-20250221-202548.png
  3. Select the checkbox next to the file name you just uploaded, and then click "Publish".

  4. A validation process will begin. Once it is complete, a pop-up window will appear. Click "Publish" again.

  5. After the process finishes, the site will reload, and the changes will be applied.

  6. Click the “Close Compilation pane” button the site will be reloaded and all changes will be already applied.


Step 2: Creating a Production API User in PayTrace

For security and to prevent integration issues, PayTrace recommends creating a dedicated API user for your integration. API users can only communicate via the API, and their passwords do not expire, so you will not have to worry about losing connectivity every 90 days.

Please ensure the API user's password does not contain any special characters.

Step 3: Configuring the PayTrace Processing Center in Acumatica

  1. In the top-left search bar, search for and select "Processing Center".

    image-20250221-201402.png
  2. Set the "PayTrace" processing center to "Active".

    image-20250221-201458.png
  3. Double-click "PayTrace" to open the configuration settings.

    image-20250221-201601.png
image-20250520-153043.png
  1. Fill in the following details:

    image-20250221-201836.png

Field

Description

Payment Plugin

Ensure this is set to PayTrace.Integration.Plugin.PayTraceProcessingPlugin.

NOT
PX.CCProcessing.AcumaticaPayments.V2.AcumaticaPaymentsProcessingPlugin

Allow Saving Payment Profiles

Enables the ability to save customer/payment profile information.

Synchronize Deletion

When a customer is deleted in Acumatica, their customer and payment information will also be deleted from PayTrace.

Accept Payments from New Cards

Allows payments from new cards.

Allow Unlinked Refunds

This must also be enabled on the PayTrace side if you enable it here.

ERREMAIL

The email address that will receive notifications when errors occur.

INTID

This will always be 999Acumatica.

Logging

We recommend enabling this to create detailed logs for troubleshooting.

MERCHID

Your PayTrace Merchant ID.

PASS

The password for the API user you created in PayTrace.

PROTECTSRC

Production: https://protect.paytrace.com/js/protect.min.js
Sandbox: https://protect.sandbox.paytrace.com/js/protect.min.js

SETTLEEACH

Automatically settles transactions as they occur.

URL

Production:
https://api.paytrace.com/
Sandbox: https://api.paytrace.com/sandbox/

USER

The username for the API user you created in PayTrace.

  1. After entering all the information, select "Test Credentials" to confirm that your username and password are correct.

    image-20250221-202021.png
  2. Once the test is successful, you must "Save" the page before navigating away from it.

    image-20250221-202109.png

Now that PayTrace has been added as a payment processor, you'll need to add it to your customer profiles.

Step 4 (Optional): Adding Trace ACH

  1. If using Trace ACH, the user will also need to add that in the PAYMENT METHODS tab

  2. image-20260803-174349.png
  3. Click on the PAYTRACE Payment Method

    1. Click the “+” icon

      image-20260803-174418.png
    2. Enter details as shown (The Payment Method ID can be whatever the merchant wants it to be, as long as they know it’s for ACH)

      image-20260803-174037.png

       

      1. Note: Means of Payment must be set to Credit Card in order for it to process through the PayTrace gateway. Select “Is ACH Method” so that this payment method will give the user the ability to enter ACH details instead of credit card details

  4. Now that we’ve added PayTrace as a Payment Processor for the merchant, you’ll need to add the PayTrace Payment Processor to customers. Please see https://paytrace.atlassian.net/wiki/spaces/PM/pages/3705045037 for further details.

 

If you have questions - please contact support@paytrace.com