Release Notes
v2.27.4 (Summer '24)
customisable domain for payment & authorisation url (live protectedpayments net) overview you can now customise the subdomain for your payment and authorisation urls to better align with your brand, using the format \<mycustomsubdomain> protectedpayments net to use this feature, follow the steps outlined below setup step 1 create a connected app in salesforce navigate to app manager go to set up > app manager click on 'new connected app' enter app details connected app name choose a name, e g , paymenturlapp callback url enter your desired url, including the https prefix, e g , https //mycustomdomain protectedpayments net (ensure it ends with protectedpayments net) selected oauth scope select "full access" and "perform requests at any time" save and record credentials after saving, navigate to 'manage consumer details' note down the client key and secret key for use in step 3 step 2 configure custom settings add custom url go to set up > quick find > custom settings > asperato one settings > server url enter the full url, including the https prefix, e g , https //mycustomdomain protectedpayments net step 3 contact mailto\ support\@asperato com to add your custom domain to our server we will need to know the domain and also whether it is for test or live step 4 reconnect asperato with salesforce connect in asperato setup go to 'asperato set up' from the app launcher menu click 'set up configuration' and enter the client and secret key obtained earlier click 'connect' and then 'reconnect salesforce' to complete the authentication verify configuration ensure all sections on the setup page have green ticks, indicating successful setup final step testing your custom domain create a new authorisation or payment record to test your new custom url additional payment options apple and google pay we have provided the ability for you to collect payments via apple or google pay, allowing enhanced customer convenience which may lead to higher conversion rates, giving you a competitive edge how it works both apple and google pay work off card payment rails to use this, you should have 'card' as the payment route option on either the authorisation or payment record if there is an active card in the wallet, then apple or google pay will appear as the payment option alongside card on that payment page if an active wallet does not exist, your users will not see this an an option to pay by setup step 1 you will need to ensure that you are using one of these psp connections stripe connect payonomy gateway other psps will be available in the future or upon request please speak to our support team for assistance at mailto\ support\@asperato com step 2 create a psp connection under your merchant group for 'ecom' for gbp step 3 on the authorisation or payment record/s make sure that card is set in the payment route options field apple pay contact your psp to enable apple pay contact asperato support to enable apple pay for each merchant group you wish to use this as a payment option for domain verification (if using an iframe) inform asperato of your domain url(s) asperato will register your domain with apple and provide verification files host these files on your server for verification complete these steps at least 2 3 days before going live to ensure proper propagation note if using an iframe for apple pay the upload of these files is time sensitive and needs actioning as soon as possible after the files have been generated by us we would advise that this is done at least 24 hours but ideally 2 3 days before any testing or live payments are due to be taken on the iframed paypage the ssl certificates need to be renewed at least 2 weeks before they expire we will advise you of the date that this is due to expire however it is your own responsibility to ensure that these are kept up to date within the timeframes given otherwise it will interrupt your apple pay service google pay contact your psp to enable google pay contact asperato support for configuration per merchant group note if using an iframe, google pay does not require the domain verification process pure text url for the ecommerce/pay now link on both payments and authorisations a plain text url field (without the html tags), is now available for easier integration into email templates to use, add the field asp04 ecommerce link c into your desired email templates defect fixes in 2 27 4 there were some defects found in version 2 27 3 which have been fixed in 2 27 4 these are the formula field (asp04 ecommerce link c) for the ecommerce url was incorrectly defined on the payment object there was a permission missing in the following permissions sets asperatofulladmin, asperato refund and asperato admin without setup this has been rectified and added how to upgrade to asperato 2 27 4 if you are upgrading from versions prior to 2 22, then please ensure you follow the steps in the release notes for each version in particular release 2 21 documentation https //payonomy freshdesk com/a/solutions/articles/43000701091 around the merchant group fields this is critical to the smooth running of this version the installation link is here https //test salesforce com/packaging/installpackage apexp?p0=04tj7000000d2x7 https //login salesforce com/packaging/installpackage apexp?p0=04tj7000000d2x7 to install in production swap the 'test' prefix for 'login' or directly install our package from the app exchange important note you must ensure that the 'connected user' the person who clicks 'connect' on the asperato set up tab has the asperato full admin permission set applied to them this person needs to be an active user at all times in the org 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 collections functionality is now classed as a record type of inbound you must add the correct record type to any and all existing asperato user’s profiles upon upgrade to version 2 18 1 and beyond if you are not using outbound payments simply remove the outbound record type from the payment and authorisation objects ( https //payonomy freshdesk com/support/solutions/articles/43000723282 removing outbound record types from payments authorisations ) we recommend following salesforce best practices on app upgrades by installing the package for admins only and in sandbox orgs first before deploying to production the salesforce setting 'enable notifications in lightning experience and salesforce mobile app' needs to be set as follows \