TABLE OF CONTENTS


FinancialForce Integration - Important Note

This Release is not compatible with the FinancialForce Integration package due to the Merchant Group changes detailed below.  We have chosen not to list this release on the App Exchange due to this reason however our package remains fully security checked and verified in line with Salesforce procedures.


We do not recommend that you upgrade to this if you are a customer using the FinancialForce/Asperato Integration until Summer 23.  If you are a NON-FinancialForce customer, and you want to upgrade then please contact our support team and we will be able to advise you with the upgrade.


Merchant Group Field Changes

In response to feedback from customers, we have made changes to the Merchant Group fields on both the Authorisation and Payment objects.


Why this feature is so important:

We have made the Merchant Group a picklist field driven by the values on the Setup page. This means instead of a free text field, in which users can potentially mistype the Merchant Group or having to create a validation rule to enforce correct naming convention, the value can be simply selected from the picklist. 

If you change your Merchant Group name in the Setup page, the picklist values are automatically updated.

As a note, if you do need to change your Merchant Group names, you will need to update previous records to select the new value as the system will remove the old value from the picklist but will not amend records previously created.   If you try to process a previously created payment or authorisation with a Merchant Group name that no longer exists, the payment will error.


How it works:

  • Create your Merchant Groups via the Setup tab in the usual way
  • Navigate to the Authorisation or Payment record page by selecting the Object --> New
  • The Merchant Group field will be a picklist where you can select the appropriate value
  • Adding a new Merchant Group on the Setup page will add a new value to the picklist
  • Deleting a Merchant Group will remove that value from the picklist value set


Setup:

If you are installing versions from 2.22 onwards, then you do not need to do anything, the correct field on both objects will be on the page layout for you.


If you are upgrading from a previous version then navigate to Setup > Object Manager > Authorisation and make sure you remove the existing Merchant Group text field from any page layouts you are using, and add the Merchant Group Picklist field to the page layout instead.  Repeat for the Payment object.


Asperato object names now are prefixed with 'Asperato'

We have renamed our objects to start with 'Asperato' so that they are easy to identify when users have multiple Salesforce packages installed.  Their API names remain the same for anyone with pre-existing code customisations relying on these, but their labels have been changed to make it easier to identify them in the App Launcher.


Setup Page Currency Enhancements

We have changed our Setup page so that it considers the currencies which have been first created on the Salesforce org.


Why this feature is so important:

In order to make in easier to setup and get started with Asperato, we have changed the Setup page so that it allows you to create Merchant Groups containing only the currencies which are already created in the Salesforce org.  This will prevent any mistakes downstream when attempting to create Payments or Authorisations in currencies which do not exist in Salesforce.



Outbound (Supplier/Vendor) Payments

We have amended the Authorisation custom page to allow users to be able to add custom fields using a field set.


Why this feature is so important:

Customers using this version can now add their own custom fields to our page to make it more usable for their own business requirements eg if they have a lookup to the Account or Contact records for each Authorisation then they can add this to our page.


How it works:

  • Navigate to Setup > Object Manager > Authorisation
  • Select Field Set
  • Add your custom field to the field set and select 'Save'
  • Your field will be reflected on the Authorisation custom page

How to Upgrade to 2.21

As mentioned at the top of this document - this release is NOT compatible with FinancialForce-Asperato Integration package due to the new Merchant Group picklist.


If you wish to upgrade, please contact our Support Team via support@asperato.com or raise a Freshdesk ticket and they will provide you with the installation link.



Other Considerations

  • If you are running a package older than v2.16, please refer to release notes for all the releases in between to ensure all upgrade steps have been completed up to the latest version.
  • Record Type Changes - in version 2.18.1 we made some changes to introduce two new Record Types of Inbound and Outbound to our Payment and Authorisation Objects.  The current collections functionality is now classed as a record type of Inbound.  



--------------------------------------------------------------------------------------------------------

Contacts/Support