Switching Payment Destinations
    • 07 Mar 2023
    • 3 Minutes to read
    • Contributors
    • PDF

    Switching Payment Destinations

    • PDF

    Article summary

    Add New Payment Destination

    To access the Payment Destination Setup use the top menu bar and navigate to Setup -Transactions - Payment Destinations.


    1. Click New from the bottom right of the payment destinations list.
    2. Input Label to name the new payment destination.
    3. Select Payment Provider that matches the new provider you would like to use.
    4. Select Trust Account to track transaction amounts.
    5. Determine Spreader that will be used by default and when payments will be spread across fee buckets.
    6. Select Batch Receiver or the source of payment.
    7. Select Service Fee Bucket to determine which bucket will hold the extra charges for using the payment destination.
    8. Optional: Input name/address or opt-in to customized options.
    9. Deactivate Payment Destination.
    10. Input Provider Settings that you received from your new payment destination. This could be username/password or alternate identifiers.
    11. Click Apply.

    Your new payment destination is setup. Next you'll want to test this account before officially activating it.

    Test Payment Destination

    Access the new payment destination by navigating to Setup - Transactions - Payment Destinations

    1. Select the new payment destination.
    2. Input Sample Client from a list of test clients. This will allow you to test the payment destination on a test account first. Coordinate with customer on which client to test with.
    3. Activate payment destination.
    4. Click Save.

    Now that the payment destination is activated and set to the test account you can create a transaction on any of the accounts under the test client.

    1. Navigate to an account under the sample client you entered above. Or create a new account under the sample client.
    2. Post a transaction on the test account using test data provided by your payment destination vendor.

    Once you have a test transaction ready you'll need to setup and run the payment job under Utilities - Jobs.


    1. Select your Payment System job which should be the job that currently runs your payment exports and settlements.
    2. Add Payment System: Export Task and set the payment destination to the one you created.
    3. Add Payment System: Settle Task and set the payment destination to the one you created.
    4. Deactivate All Other Tasks except for two belonging to the payment destination you created.
    5. Click Apply.
    6. Run the Job.

    Once the job has finished running you can check the transaction by navigating to Transactions -> Today's Transactions. The test transaction should have a new status that indicates the information was properly sent to the payment destination provider. You'll want to work with your new payment provider to confirm the information was sent and is processed properly on their end.

    In addition to the import/export tasks there may also be a Payment Plans task that is in the same or different job.


    1. Select your Payment Plans job which should be the job that contains the payment plans task.
    2. Add Payment System: Payment Plans and set the payment destination to the one you created.
    3. Deactivate All Other Tasks except for the task belonging to the new payment destination.
    4. Click Apply.
    5. Run the Job.

    Make sure there are no errors when the process runs.

    After testing don't forget to re-activate the tasks you previously deactivated

    Disable Old Payment Destination

    Once you've confirmed that your new payment destination is working properly you'll want to officially switch the payment destinations. Navigate to Setup -> Transactions -> Payment Destinations.

    1. Select the old Payment Destination.
    2. Input a sample client into Clients which will limit the payment destination to only process transactions on the sample client.
    3. Deactivate the setup in order to mark it as a disabled payment destination.
    4. Click Apply.
    5. Select the new Payment Destination.
    6. Remove the sample client.
    7. Deactivate the setup to make sure the change to clients saves properly.
    8. Click Apply.
    9. Select the new Payment Destination.
    10. Activate the setup.
    11. Click Apply.

    Migrate payment plans on the system to the new payment destination. This should only be done if the customer approves. 

    To perform this task you'll need to create a new job by going to Utilities - Jobs.


    1. Create a new Job and name it Payment Plan Migration.
    2. Schedule set to On Demand to prevent it from running automatically.
    3. Add Task Payment System: Payment Plans Move from the task dropdown.
    4. Input Payment Destination from the old payment destination to the new payment destination.
    5. Click Apply.
    6. Run Job.

    Resolving Issues With Payment Vendors

    During first time setup for a new vendor there could be vendor settings that need to be adjusted. This section will identify common setting issues we've experienced with specific vendors.

    4Processing ACH

    URL: https://gateway.ach-solutions.com/requester/request.aspx

    There is a HOLD/HELD status that will be sent back when a transaction reaches specific limits determined by the customer. Our preference is to remove the limits for individual transaction, daily limit and monthly limit. In the event this message does get sent back to our system we'll need to coordinate with the customer and manually input the real status.


    Was this article helpful?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.
    ESC

    Eddy AI, facilitating knowledge discovery through conversational intelligence