Setup of Integration with Bill.com

You can directly integrate MYOB Acumatica with Bill.com—a trusted external payment processor that simplifies accounts payable. Bill.com handles the end-to-end processing of ACH payments, virtual cards, and checks, allowing you to securely delegate payment execution and focus on higher-value.

With the integration with Bill.com, you:

  • Won't need to spend time on check printing and mailing, configuring an export scenario or a plug-in for Electronic Funds Transfers (EFT), and uploading files to your banks. Bill.com will do all of this.
  • Won't need to maintain vendors' bank account details in MYOB Acumatica for vendors connected to Bill.com. Bill.com has a vendor database with prefilled bank account details and preferred payment methods. This database is kept up-to-date in case a vendor changes its name or address or goes out of business.
Attention: This functionality is available in the system if the Bill.com Integration feature is enabled on the Enable/Disable Features (CS100000) form.

For information about processing payments through Bill.com, see Creating Documents for External Payment Processing.

Configuring the Connection to Bill.com

You configure the connection to Bill.com on the External Payment Processor (AP205500) form. You create a payment processor and specify its settings, such as companies, users, and funding accounts. For details, see To Create a Payment Processor.

To be able to create a payment processor, you must have the Administrator or AP Admin role assigned on the Users (SM201010) form. Users with the AP Clerk, AP Viewer, and AcumaticaSupport roles can only view the settings.

Attention: You can create only one active payment processor on this form. An active payment processor has the Active check box selected in the Summary area.

To configure the connection to Bill.com, perform the following general steps:

  1. Onboard MYOB Acumatica companies to Bill.com.

    Once you create a payment processor on the External Payment Processor form, you add a company and click Onboard on the toolbar of the Companies table. The system creates an organization and a user in Bill.com by using an API call.

    Attention: A company can be added if all of the following conditions are met:
    • The company is active
    • The current user has access to the company in MYOB Acumatica
    • The company is located in the United States
    • The company hasn't yet been added to the payment processor
  2. Subscribe each company to a Bill.com webhook.
    Attention: For creation of webhooks, your MYOB Acumatica instance must be hosted over HTTPS.

    Webhooks allow users to track the status of payments in the external payment processor. The system automatically creates a webhook on the Webhooks (SM304000) form during company onboarding. The system makes an API request to Bill.com to create the webhook subscription.

  3. Add, activate, and onboard users to Bill.com.

    You do this on the Users tab of the External Payment Processor form. To onboard the user, you click Onboard on the table toolbar. To deactivate an active user, you click Deactivate on the table toolbar. To re-activate an inactive user, you click Activate on the table toolbar.

  4. Create and verify Bill.com funding accounts for each company.

    There are two ways of creating a funding account:

    • By using the Plaid processing center. You will need to log in with your credentials. The funding account will be created with the Verified status.
    • By entering bank details manually. In this case, after some time you will receive a bank transfer from Bill.com to your bank account. You should then enter this amount, which is usually less than a dollar, to verify that you really have access to that bank account.

    To enter bank details manually, you click the Manage Accounts button on the table toolbar. The system opens the Funding Accounts widget. You use it to create, manage, and verify the funding accounts under this organization ID. You can also identify yourself for those funding accounts.

    When you close the Funding Accounts widget, accounts are automatically refreshed. However, you can click Refresh Accounts to update the accounts that changed in Bill.com but weren't updated in MYOB Acumatica.

    Attention: If you click the Disable button or the Delete button on the Funding Accounts widget that you can open with the Manage Accounts button on the table toolbar, the selected funding account will be permanently disabled.
  5. Map a funding account to a cash account.

    You do this by selecting an active cash account in the Cash Account column on the Funding Accounts tab.

    Attention: A cash account can be mapped to a funding account if all of the following conditions are met:
    • The cash account is assigned to the company on the Cash Accounts (CA202000) form
    • The cash account is nominated in U.S. dollars (USD)
    • The cash account hasn't been mapped to another funding account even in a different company in the same processor
  6. Verify your identity for each company to use its verified accounts.

    Once you verify your identity on the company level, you'll be able to use all the accounts that were already verified or will be verified in future.

    All users who are onboarded on a company are nominated for all the verified cash accounts in either of the following ways:

    • When the user is onboarded
    • When the account is verified

    You verify yourself on the Funding Accounts tab by clicking Manage Accounts. Alternatively, you can verify yourself on the User Profile (SM203010) form, as explained in the section below. Another way of verifying yourself is by clicking Verify Funding Accounts on the Process Payments / Print Checks (AP505000) form.

    You can click Refresh Accounts to update the users of the funding accounts that changed in Bill.com but weren't updated in MYOB Acumatica.

    Attention: If you click the Disable button, the selected user will be permanently disabled from using the funding account.

For detailed steps of configuring the connection, see To Configure a Connection to Bill.com.

Setting Up the Payment Method

For integration with Bill.com, the External Payment Processor means of payment is used. You set up a payment method on the Payment Methods (CA204000) form. For details, see To Create a Payment Method for External Payment Processing.

Verifying the Vendor Settings

For a vendor to get connected to the Bill.com network, you should make sure that it has a correct name and address in MYOB Acumatica.

For vendors not connected to Bill.com, you should make sure that their bank details are up to date. These settings are located in the Payment Instructions section on the Payment tab of the Vendors (AP303000) form.

Bill.com will try to verify the bank account and if it gets verified (usually within one or two working days), they will start paying the vendor through ACH. If the verification fails, they will send a check to the vendor's address that you specified in MYOB Acumatica.

For details, see To Set Up a Vendor for External Payment Processing.