---
title: v2.31 (Spring '25)
slug: payments/v231-spring-25
docTags: eCzPis-CE5irhExGkAjFd,5xAjFmin_she9ONpEFcqt,dPk9wqOxVTMhTDM3mbo2Z
createdAt: 2025-05-14T10:12:53.520Z
---

## New features

### ACH Payments via Cybersource

ACH payments through Cybersource (Bank of America) to collect payments directly from U.S. customer bank accounts.

**How to set up**

1. Create a PSP Connection on the **Asperato Setup** page under your chosen Merchant Group for *Echeck* and *Cybersource (Bank of America).*
2. Enter your Cybersource credentials and click **Create PSP Connection**.
3. Create your Payment and/or Authorisation records with *Echeck* included in the Payment Route Options.
4. Cybersource (Bank of America) requires a telephone number and this field must be added to Salesforce on both the Authorisation and Payment page layouts manually

:::hint{type="warning"}
- Payments are set to *Collected from Customer* once they are successfully sent from Asperato, however, webhooks are unsupported for this payment gateway. For information about late failures, you will need to check your Cybersource account.
- Cybersource (Bank of America) does not support standalone. For recurring payments, you will need to combine authorisations and payment records. When the first Payment record is processed, it will set the Authorisation to an *In Force* status and assign repeat tokens to allow future payments to be collected automatically. 
- Refunds are processed by Asperato adhering to Cybersource timelines for transactions.
:::

### Klarna Integration

Offer flexible payment options via Klarna:

- **Pay in 3**: Split into three interest-free installments.
- **Pay in 30**: Pay the full amount 30 days post-purchase.
- **Pay in Full**: Standard checkout.

**How to set up**

1. **Create a PSP Connection**
   1. Navigate to **Asperato Setup **page and connect Klarna for required currencies.
2. **Update picklist values (if upgrading): **If you are upgrading from a previous version of Asperato, you need to manually add *Buy Now Pay Later* to the **Picklist Value Set**.
   1. Go to Setup > Objects and Fields > Picklist Value Sets > Payment Route Options.
   2. Add Buy Now Pay Later as a new value.
   3. Assign it to **Inbound Record Type Picklists** for both **Payment Route Options** and Payment Route Selected.
3. **Create Payment records**
   1. Select *Buy Now Pay Later* in **Payment Route Options**.

:::hint{type="warning"}
- When a customer chooses *Pay in 3* or *Pay in 30*, your payment record will display the full payment amount. Klarna manages installment arrangements directly with customers.
- Klarna does not support Authorised Recurring Payments via our Authorisation object.
:::

### Bank details validation 

Validate UK bank details for customers and suppliers to reduce processing errors. Asperato validates key fields such as **Account Number** with **Account Name** and **Sort Codes** at the point of entry. Once the Authorisation has been validated, the **Validation Status** and **Validation Status Description** fields are populated on the record with the outcome. The user entering the details on the PayPage will also see the outcome of the validation.

Responses for validation are:

- *PASS: *Details matched successfully.
- *CAUTION: *Possible typo. The response will suggest a close match.
- *FAIL: *Validation unsuccessful.

:::hint{type="info"}
Contact support to enable this feature at [support@unaric.com](mailto\:support@asperato.com).
:::

:::hint{type="warning"}
For this release, the Validation service is only applicable for **UK Bank Accounts**.  Should you wish to validate other Countries, please contact support\@unaric.com and request this for consideration by our Product team.
:::

:::hint{type="warning"}
Bank details are returned to Salesforce **unmasked**, so if you use them with another PSP they are available for use however you may want to add your own masking or encryption on the page to prevent the details being visible to users.
:::

**How to set up**

1. **Update page layouts**
   1. Add the*Validation Status* and *Validation Status Description* fields to your Authorisation page layout.
   2. Ensure the *Process Authorisation* button is on the page layout.
   3. Add the *Account Validation* value to the **Payment Route Options Global Value Set** and ensure **Add the new picklist values to all Record Types that use this Global Value Set** is checked.
2. **Prepare for validation**
   1. In order to submit records for validation, you will need to enter a *United Kingdom *as **Bank Country** in the Authorisation record page. If this field is not on your page layout, you must add it (the field is **Bank Country **and it is the Free Text field, not the Picklist field)
   2. To validate personal details, ensure the** First Name** and** Last Name** fields are populated on the Authorisation record; to validate Company details, ensure that the **Company Name** field is populated. 
3. **Submit for validation**
   1. Option 1: Send the PayPage link to customers to enter their details directly.
   2. Option 2: Have an internal agent input details over the phone.
      (*Contact the Customer Success Team for PayPage setup guidance*)

## Upgrade to Asperato 2.31

### Prerequisites

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.

If you are upgrading from Asperato versions prior to 2.22, ensure you follow the steps in the release notes of each version. In particular, [v2.21 (Spring '23)](docId\:OG4DwtZvBLNxdauRqPIca) documentation around the **Merchant Group fields**. This is **critical **to the smooth running of this version.

From [v2.18.1 (Spring '22)](docId\:pGMo23zMIdWH_W9m3Q-SQ), two new record types (*Inbound *and *Outbound*) were added to Payment and Authorisation objects. You will need to add the *Inbound* record type to all Asperato user profiles. If **Outbound payments** are unused, remove them from the aforementioned objects following the instructions at [Additional Options](docId\:MYxfI9EEL8vLA5WlO2-hi). 

To avoid issues with the update, make sure the Salesforce notifications setting **Enable notifications in Lightning Experience and Salesforce mobile app **is set as follows:

![](https://api.archbee.com/api/optimize/10Nod6Ww95R3dPr0k0TCJ/XtPFT9GUS8Qt9xIcVFkCX_image.png)

### Installation steps

1. **Install the package**
   1. Sandbox/Test Org: [Install Asperato 2.31 in Sandbox](https://test.salesforce.com/packaging/installPackage.apexp?p0=04tJ70000004hVF)
   2. Production Org: [Install Asperato 2.31 in Production](https://login.salesforce.com/packaging/installPackage.apexp?p0=04tJ70000004hVF)

      Alternatively, install directly from the Salesforce App Exchange.
2. Post-installation configuration
   1. Assign the Asperato Full Admin permission set to the Connected User (the user who clicks Connect on the Asperato Setup tab).
   2. Ensure the Connected User remains active in your Salesforce org. Changes to this user may disrupt payment processing.

:::hint{type="danger"}
You must ensure that the **Connected User,** the person who clicks **Connect** on the **Asperato Setup** 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. Any changes to this user will affect how your payment records are processed.
:::

### Troubleshooting

If issues arise post-upgrade, cross-reference the [v2.21 (Spring '23)](docId\:OG4DwtZvBLNxdauRqPIca) release notes for Merchant Group field updates. Contact **[Asperato Support](mailto\:support@asperato.com)** for unresolved issues.