Setting Up Smart Resolution with Your Billing Statement Descriptor

Integrating your Smart Resolution link into your payment statement descriptor ensures customers can quickly resolve issues directly from their bank statement, helping reduce chargebacks and improve trust. Below are detailed steps for Shopify and Stripe users, along with notes for other payment processors.

Step 1: Create a Resolution URL

Choose a simple URL on your store to act as the resolution landing page.
- Example: yourstore.com/help or help.domain.com
This page will be redirected to your resolution page, while helping customers still recognize who they purchased from.
Ensure the URL is easy to read and represents your brand clearly, as it will appear on bank statements.

Step 2: Set Up a URL Redirect

For Shopify Stores

Set Up a URL Redirect in Shopify

URL redirects allow you to create a simple, memorable URL on your Shopify store (such as yourstore.com/help) that automatically sends customers to your Smart Resolution page. This makes it much easier to include the link in emails, SMS messages, customer support responses, and social media.

Before You Begin

Make sure you have:

Access to your Shopify Admin.
Your Smart Resolution URL (provided by Disputifier or your Smart Resolution dashboard).
The custom URL you'd like customers to use (for example: /help, /returns, /support, or /resolution).

1: Log into Shopify

Open your Shopify Admin.
Sign in using your administrator account.

2: Navigate to URL Redirects

From the left navigation menu, click Online Store.
Select Navigation.
Click View URL Redirects (or URL Redirects, depending on your Shopify version).

3: Create a New Redirect

Click Create URL Redirect.

You'll see two fields:

Redirect from

Enter the path customers will visit.

Examples:

/help

/support

Note: Only enter the path beginning with /. Do not include your full website address.

Correct:

/help

Incorrect:

https://yourstore.com/help

Redirect to

Paste your complete Smart Resolution URL.

Example:

https://refundrescue.com/storename

Be sure to include the entire URL, including https://.

4: Save the Redirect

Click Save.

Your redirect becomes active immediately.

5: Test the Redirect

Open a new browser tab and visit your new URL.

Example:

https://yourstore.com/help

You should automatically be redirected to your Smart Resolution page.

If the page doesn't redirect:

Double-check that the "Redirect to" URL was copied correctly.
Make sure there are no extra spaces.
Try testing in an Incognito/Private browser window.
Clear your browser cache if necessary.

For Other Platforms

Most platforms allow redirects through your hosting provider or CMS. Ensure the URL forwards to your Smart Resolution link without errors.

Step 3: Update Your Statement Descriptor

Your statement descriptor is the text that appears on a customer’s credit card or bank statement. You can include your brand name and your resolution URL to make it easy for customers to resolve disputes.

Option A: Shopify Payments

In Shopify Admin → Settings → Payments → Shopify Payments → Manage.
Scroll to Statement descriptor.
Update it to include your brand and the short resolution URL (
- Example: help.domain.com
Click Save.

Note: Only Shopify Payments allows self-service updates. For more details: Change your Shopify Payments statement descriptor

Option B: Stripe

Log in to Stripe Dashboard.
Go to Settings → Account details → Statement descriptor.
Enter your brand name or short resolution URL.
- Maximum 22 characters; only letters, numbers, spaces, and allowed symbols (-, ., ').
  Foor example: help.domain.com
Save changes.
Optionally, for dynamic per-charge descriptors, you can set the statement_descriptor parameter in your API integration to include order IDs or unique resolution links.

Option C: Other Payment Processors

If you are not using Shopify Payments or Stripe, changing your statement descriptor usually requires contacting your processor directly.
Provide them with your desired descriptor (including your short resolution URL) and ask them to update your account settings.
Examples include: PayPal, Adyen, Square, Authorize.Net, etc.

Step 4: Test Your Setup

Make a small test purchase to ensure the redirect works and the statement descriptor displays correctly.
Verify that customers clicking the link are directed to the correct Smart Resolution page.

Step 5: Updating the App with the Correct Instructions

Login to the Chargeback Management App
Head over to Smart Resolutions > Setup > Statement Descriptor Resolution Link
Add your new descriptor under New descriptor with redirect and click Save
Mark as Done under Descriptor changed and Redirect created