Acumatica Payments Setup guide

Here is how you set up Acumatica Payments in 2023r2 version of Acumatica ERP.

Prerequisites

Make sure you have the details needed to connect to your Processing Center.

For Acumatica Payments you need the following values APIKEY, HASHKEY, LOCATIONID, USERID.

It usually looks like the following:

LOCATIONID: 11eda672c8d689b4ae137d65

USERID: 11ecb74a72b0eb6ba237fcd7

APIKEY: 41db9b32681e5a2ea1122e40

HASHKEY: e6f8fe93f9479c330148c9e1

 

To get these values, you need to log in to your merchant account, using https://[yourcompany].sandbox.zeamster.com/ for the sandbox account or https://[yourcompany].zeamster.com/ for the live account.

Then navigate to your profile settings → Advanced to generate Hash Key and API Key

Then go to Locations → Your Location and copy Location Id.

Then go to the settings of the location→ users

Select your user and copy the UserID

 

In Acumatica make sure you have the following settings.

1. The Acumatica Payments feature is active on the Enable/Disable features form (CS100000)

   

2. On the Accounts Receivable Preferences form (AR101000) set Default Customer Class and Enable Integrated CC Processing

   

3. Make sure you have Chart of Accounts and Cash Accounts set up (you’ll need your Bank Account and a Clearing account as Cash Accounts).

Basic Configuration of Acumatica Payments

1. Go to the Processing Centers form (CA205000) and create a new Processing center.
2. Give it a name.
3. Select a cash account that has the same currency you’ll be working with.
4. Set Active to true.
5. Select Payment Plugin = Acumatica Payments plug-in.
6. In plugin parameters fill APIKEY, HASHKEY, LOCATIONID, USERID.
7. Set Test Mode to Test or Lice depending on what you are setting up.
8. Save 

   

    

9. Go to the Payment Methods form (CA204000)
10. Create a new Payment Method for Credit Cards or use existing Credit Cards payment method.
11. Important settings to set on CC Payment Method:
    1. Means of Payment = Credit Card
    2. Use in AR=true
    3. Allowed Cash Accounts – select one or multiple. Recommended to set one of the as AR Default =true

       

        

    4. Settings to use in AR-> Integrated Processing = true
    5. Processing Centers -> Add Acumatica Payments processing center and recommended to set Default=true
    6. Save

If you are going to use EFT/ACH payment methods along with Credit Cards, please set up the Payment method for that too.

You can now make credit card payments in the system!

Configuring Payment Links

1. Go back to your Acumatica Payments Processing center.
2. Check ‘Allow Payment Links’ checkbox.
3. Click ‘Create/Update webhook’. That should allow payments to be created once they are received without a need to run the synchronization process. (Webhooks do not work with locally deployed instance).
4. Open tab Payment Links tab
5. Check Allow Partial Payment if needed
6. Make sure Webhook ID is present
7. For each branch that you are planning to send links from create a line in the grid and fill either Credit Card related fields, or EFT Related fields or both depending on whether you are going to use CC, EFT or both. It is recommended to set Use by default = true.

8. 

   Save the processing center.

9. Open Customer Classes form (AR2010PL).
10. For each customer class define whether you want to exclude this customer class from links processing and whether you want to Allow EFT, CC or both payment methods for that customer class. Also define if you want to automatically send the pay link notification using Delivery method box. The default values are: Include in payment links process, don’t send email notifications, allow both CC and EFT.

    

     

11. Go to the Email Templates form (SM2040PL) and change the Invoice Payment Link or Sales Order Payment Link email template if needed.

    

     

12. Go to the Invoice/Memo or Sales Order printed form and make sure QR code for payment link is printed on the form and modify it if needed.

    

The setup is now complete!