How to Create an Authorize.Net Sandbox Account

The Authorize.Net Sandbox is necessary to test the Easy EFT Payment processing application. This sandbox environment will only simulate connections to the card networks. No actual card processing will be performed.

Click here to create a free Authorize.Net Sandbox account.

Click here to log into your existing Authorize.Net Sandbox account.

As soon as a new Authorize.Net account has been created, your API Credentials will be displayed near the bottom of the page.

Find Your Authorize.Net Profile ID and Transaction Key

Click here to create a free Authorize.Net Sandbox account.

Click here to log into your existing Authorize.Net Sandbox account.

Click on Settings from the section labeled Account in the left-hand column of the page.

Under Security Settings, click the link for API Credentials and Keys

Your API Login ID will be displayed like so:

You will be required to generate a new Transaction Key.

You will need to verify with a verification key sent to the email address used to create the sandbox account.

Easy EFT Setup Guide

The Easy EFT Setup guide will help you finalize your setup for Easy EFT. Here you will need to set up the following:

• Connection Details
• Posting Setup
• Web Service Info (for Advanced Subscription only)

Once you have your Profile ID and Transaction key, go back to Dynamics 365 Business Central and navigate to Easy EFT Setup.

We will enter this information into the Connection Details.

Enter your API Login ID and Transaction Key in the appropriate fields.

The Solution ID will be auto-populated.

HTTP Post Request API

For the Trial Subscription, use https://apitest.authorize.net/xml/v1/request.api

For a paid subscription, use https://api.authorize.net/xml/v1/request.api

Posting Setup

Create and select the following suggested posting setups or consult with your accounting team for the best setup for your organization.

Web Services Setup

Web Services will enable you to send an email to customers with a link for payment. You must have SMTP setup on your BC environment to be able to send payment links to customers.

See How to Setup a Webservice

How to Find Your Web Service Credentials

To find the information needed to complete the Web Service Setup, navigate to Users.

Open the card for the user assigned as the administrator of web services.

You will enter the User Name from the Users card as the Web Service User Name on the Easy EFT Setup page.

How to Upgrade to the Advanced Subscription

If you find that you have out-grown the Basic Subscription by needing to store multiple cards-on-file for your customers, or would like to make use of the Payment Link by email feature, simply run the Assisted setup once again selecting the Advanced Subscription in the Wizard.

Search web service in Business Central

Click on a new button and create web services as highlighted and make sure it is published.

Search user in Business Central

Select any user:

Search Easy EFT setup and make sure Web Service Info details are filled:

Web service key

Easy EFT for BC User Guide v2

Easy EFT Support Portal

API Reference

Testing Guide

Convenience Fee

Brief

Convenience Fee is a new feature in EasyEFT introduced in version 21.0.0.4; its purpose is to pass the expense of credit card processing costs to customers. As a Business Central administrator, you can define the fee in percentage value, and this fee will be added to the payment.

Convenience Fee is triggered only when a payment is made, in other words it is calculated upon payment. It is not calculated up front during Sales Order creation for example.

Examples:

Convenience Fee amount is always in addition to the total invoiced value. Lets discuss one of the  examples:

Example 1: Sales Order is invoiced and its total invoiced value is $100.00, if Convenience Fee is setup at 3%, total payment is captured for $103.00. This marks the invoice as overpaid. When Cash Receipt Journal is processed by running ‘Suggest CC Payments’ batch job, Convenience Fee invoice is created automatically and both original and fee invoice are applied to $103.00 payment.

Example 2: Already invoiced sales documents are suggested into Cash Receipt Journal using ‘Suggest Payments Due’ batch job. Amounts of these invoices reflect original invoiced amounts, but when payment is captured, each invoice is overpaid and Convenience Fee invoice is created automatically and both original and fee invoices are applied to corresponding payments.

Setup:

You need to turn on Convenience Fee in EasyEFT Setup and create a new number series for invoices related to this fee. Convenience fee will be charged on a separate accounts receivable invoice.

Convenience Fee Account Type should be selected. Please note that currently only G/L Account is supported.

Select appropriate income G/L Account

Enter Convenience Fee %

Convenience Jnl. Template Name should be selected, typical choice is GENERAL because General Journal will be used to post these entries.

Convenience Jnl. Batch Name – it is recommended that new batch is created, for example CFEE with Description ‘Convenience Fees’

Convenience Fee is added to any payment that is considered credit card payment. EasyEFT specifies credit card payment method on EasyEFT Setup page.

If you are on this page, you probably want to upgrade EasyEFT to version 20.0.0.4 or later. This version includes critical update that allows Business Central and EasyEFT to communicate using oAuth protocol instead of basic authentication, which was recently deprecated by Microsoft.  As a result, Payment Link functionality will not work until your EasyEFT extension is upgraded to the latest version. Any existing Payment Links will not be operational, and after upgrade is completed, you will need to send out new payment links for those customers who haven’t used their links yet.

Upgrade of the extension requires completion of following steps. Please keep in mind that this only affects EasyEFT Advanced subscriptions, if you are using Basic subscription, please disregard this notification.  If you are unable to complete these steps, please submit a ticket on our support portal. If you do not have access to support portal, please call our office at 941-914-9144.

1. Upgrade your EasyEFT extension to latest version 20.0.0.4 if you do not know how to upgrade your extensions, you may follow easy instructions here.

Please note:

• this new version will only be available to you if you have already upgraded your Business Central to version 20.0 or later. If you are on an earlier version, we encourage you to upgrade your Business Central instance as soon as possible. More on how to upgrade your Business Central instance can be found here.
• this version of EasyEFT introduces new permission sets. You must assign new permissions to all users after this upgrade. Old permission set EASYEFT will not be valid anymore, instead EASYEFT – PROCESS will be

2. You will need to register an Application in your Azure AD. This is required because EasyEFT needs to securely authenticate to Business Central. While registering this app, please save Tenant ID, Client ID and Secret Key as you will need them in step 4.  More on registering an application in Azure AD can be found here. See “How to Register AzureAD Application for EasyEFT’ section.

3. You will also need to register the Application in Business Central, and assign permissions to it, so that both Azure AD Application and Business Central are connected.

4. Update settings on EasyEFT Setup page on oAuth FastTab. Fields that need to be updated: Tenant ID, Client ID and Secret Key.

5. After step 4 is completed, please click on ‘Get Webhook Link’ action on EasyEFT Setup page and copy the generated URL into clipboard.

6. Login to your Authorize.net account and go to Accounts, under Business Settings, Notification Settings, Webhooks.

click on edit option (Note that due to the fact that the webhook url is rather long, you may need to scroll to the right to find the ‘Edit’ icon.) for existing endpoint and replace the URL with what you copied in previous step. Press Save.

Completing these steps will ensure that your environment and processing payments is secure.

Navisiontech Support Team

Using OAuth to Authorize Business Central Web Services (OData and SOAP)

To accomplish this, we have to Register an application for BC in Azure AD Tenant as follows.

1. Sign in to Azure portal and open the Active Directory tenant.

2. Registering the application

3. Provide name for application and Redirect URL

4. Define the redirect URI on the bottom of the page.

This Url can be either

• https://businesscentral.dynamics.com/OAuthLanding.htm
• https://lscentral.bc.dynamics.com/OAuthLanding.htm

Depending on your Application Family. You will be able to see this in the browser when you are using Business central. Just add the OAuthLanding.htm to the end of the URI

5. After you registered the application, set the Application ID URI for the application:

• • From the Overview page for your app registration, next to the Application ID URI label, select Add an Application ID URI.

6. On the Expose API page, next to the Application ID URI, select Set.

• • The Application ID URI box displays the default application ID URI. It has the format api://, such as “api://70b20a51-46b7-4290-8686-b79ec90379f6”. You can keep this value or change it. The application ID URI must be a valid URI starting with HTTPS, API, URN, MS-APPX. It must not end in a slash. To use an HTTPS URI, for example https://cronusinternationltd.onmicrosoft.com/businesscentral, it must be a verified domain. Select Save when done.
•  7. Go to API Permissions and select add a permission. From the window select Dynamics 366 Business Central.Then select the options highlighted below for the permissions to allow.

8. Next you will Grant admin consent to the permission you just selected.

You will click confirm in the popup window. Then you will see the lines updated to a status of granted.

9. Next click on Certificates & secrets. Click on “New Client secret”. You will see a prompt for Description and Expiration. You can enter EasyEFT into description and select desired expiration. Remember that when secret value expires you will need to renew it and adjust settings in your EasyEFT setup. 

You will see a confirmation with Value and Secret ID, take note of these values, especially the Value, you will need to specify it in later steps in EasyEFT setup

The Business Central solution is now registered in your Azure AD tenant. To complete the steps that follow, you’ll need the tenant’s domain (Directory (tenant) ID), Redirect URI, and Application ID URI. You find this information in the Azure portal by selecting Overview for the registered application.

You can select the endpoints and the page will open to access links. So, make a note of or copy the values for these settings for later use.

In Business Central search for ‘Azure Active Directory Application Card’. Press New and paste Client ID into the respective field.

Give the record a description, EasyEFT is a good logical description. 

Give EASYEFT – PROCESS permission set to this Application and enable it.