---
title: Button Images
slug: payments/button-images
description: Customize payment button images and styles in Unaric Payments to match your branding on checkout pages.
createdAt: 2025-02-18T05:16:09.154Z
---

## *Pay Now* button image

The default **Pay Now** image is available in the “Pay Now Image” field on the Payment record. You can use this image to create a clear call to action for your customers, encouraging them to complete their payments. You can display this field on your Payment page layouts or use it in other Salesforce configurations to show the “Pay Now” button to your customers.

### Customize the *Pay Now* image

Personalize your customer's payment journey by using your own “Pay Now” image. The process to use a custom image is now simpler. You no longer need to create formula fields.

:::hint{type="info"}
The displayed image width is fixed at **150 pixels**. The height will adjust according to your uploaded image’s aspect ratio. Ensure your image renders correctly within this space.
:::

1. Go to **Setup** **>** **Static Resources.**
2. Click **New**.
3. In the **Name** field, enter *PayNowImage*. **This name is case-sensitive and must be exactly as written. ** **The customization will not work with any other name.**
4. Click **Choose File** and upload your desired image file.
5. Set **Cache Control** to *Public*.
6. Click **Save**.
7. Go to **Setup** **>** **Custom Settings**.
8. Click **Manage** next to **Unaric Payments Settings**.
9. Click **Edit** (or **New**, if you have not configured settings before).
10. Locate the **Use custom pay now image** setting. (The exact label may vary slightly in your Salesforce org).
11. Select the checkbox to enable this setting.
12. Click **Save **to finish. Your custom image named *PayNowImage* will automatically appear in the **Pay Now Image **field on your Payment records.  

### Benefits of the Simplified Process

This updated method simplifies the process of customizing your “Pay Now” image. You no longer need to create formula fields or manage image URLs manually. Personalize your customer's payment experience easily by uploading a Static Resource with the correct name and enabling a custom setting.

### For Previous Formula Field Users

If you previously used a formula field, you can now remove it. It is no longer necessary to display a custom “Pay Now” image. The system now automatically handles the image display using the Static Resource and custom setting.

### Plain Text URL

A plain text URL field is available for the Ecommerce/Pay Now link on both Payments and Authorisations. This URL, without HTML tags, simplifies integration into email templates.

To use this feature, add the **asp04\_\_eCommerce\_link\_\_c** field to your desired email templates. This field contains the plain text URL, ready to be inserted directly into your email content.

## *Add Payment Method* button image

To simplify the process of collecting customer payment information, Unaric Payments provides a default "Add Payment Method" button image. This pre-built image can be used immediately, eliminating the need for custom image creation.

Requesting payment method details is a frequent task. This pre-built button streamlines the customer experience, making it easier for them to provide their card details or set up a bank mandate.

### How it works

A default **Add Payment Method** button image is included. This image (which can be replaced with your own) is displayed in the **Authorisation Image** field on the **Authorisation** record. Determine the best way to present this image to your customers to encourage them to provide their authorisation details with minimal clicks.

### Customize the *Add Payment Method* Button

While the default image is readily available, you can use a custom image if desired. To do so:

1. Navigate to **Setup > Static Resources**
2. Upload your custom image. The recommended width is 150 pixels; the height will be determined by the uploaded image. Keep this in mind for proper image rendering.
3. Go to **Setup > Custom Settings** and select **Unaric Payments settings**.
4. Check **Use Custom Auth Image**.
5. Create a custom formula field on the **Unaric Payments Authorisation** object. The formula should generate a hyperlink that includes your custom image. The following example provides a starting point, but you can adjust it to meet your specific needs:

:::BlockQuote
IF( asp04\_\_eCommerce\_URL\_\_c != null, 
    HYPERLINK(
        "https\://" + $Setup.asp04\_\_AsperatoOneSettings\_\_c.asp04\_\_Server\_URL\_\_c + "/PMWeb1?pmRef=" + asp04\_\_Customer\_ID\_\_c + "\&aid=" + Id + "\&locale=" + TEXT(asp04\_\_Language\_\_c) +"\&dit=" + asp04\_\_Data\_Integrity\_Token\_\_c ,
        IF(
            $Setup.asp04\_\_AsperatoOneSettings\_\_c.asp04\_\_Use\_Custom\_Pay\_Now\_Image\_\_c ,
            IMAGE("/resource/YourCustomImageName", "Add Payment Method", -1, 150), // Replace YourCustomImageName
            IMAGE("https\://live.protectedpayments.net/donationline/images/auth\_img.png", "Add Payment Method", -1, 150) // Default Image
        )
    ),
    null
)
:::

:::Paragraph{indent="1"}
**In this formula:**
:::

:::Paragraph{listStyleType="disc" indent="2"}
**asp04\_\_eCommerce\_URL\_\_c:** Checks if an Ecommerce URL exists.
:::

:::Paragraph{listStyleType="disc" listStart="2" indent="2"}
**HYPERLINK(...):** Creates a link to the authorisation page.
:::

:::Paragraph{listStyleType="disc" listStart="3" indent="2"}
**$Setup.asp04\_\_AsperatoOneSettings\_\_c.asp04\_\_Server\_URL\_\_c**: Retrieves the server URL from custom settings.
:::

:::Paragraph{listStyleType="disc" listStart="4" indent="2"}
**asp04\_\_Customer\_ID\_\_c, Id, asp04\_\_Language\_\_c, asp04\_\_Data\_Integrity\_Token\_\_c**: Include necessary parameters in the URL.
:::

:::Paragraph{listStyleType="disc" listStart="5" indent="2"}
**$Setup.asp04\_\_AsperatoOneSettings\_\_c.asp04\_\_Use\_Custom\_Pay\_Now\_Image\_\_c**: Checks if the custom image setting is enabled.
:::

:::Paragraph{listStyleType="disc" listStart="6" indent="2"}
**IMAGE(...):** Displays either the custom image (if enabled) or the default image. Remember to replace `YourCustomImageName` with the actual name of your static resource.
:::

6. After completing these steps, your custom image will be displayed on the **Unaric Payments Authorisation** record in the custom field. You can toggle between the default and custom images using the custom setting.