Syncing merchant locations ⚡️

Syncing Merchant Locations to your Programs

We’ve made the process of syncing merchant locations for programs simple. At a high-level, syncing merchant locations involves adding all merchant locations to each program and then sending the locational information to the applicable card schemes (Visa, Mastercard and/or Amex), in order to make sure your program is ready to process credit and debit card transactions.

:alarm_clock: Total time to sync all merchant locations: 3-4 working days

The Process: :clipboard:

  1. To add a merchant location, login to your Fidel Dashboard account (, go to ’ Programs ’ and click the " + " button on the top-right. For adding multiple locations, use the Create Location API.

Hint - to speed the approval process submit all Merchant IDs with the location information.

  1. Once you have added the locations you would like to sync into your program, you can initiate the location sync on the dashboard.

  2. Wait for submitted locations to be approved and synced by all applicable card-schemes (Visa, Mastercard and Amex)

  3. Once locations are synced, you’re ready to go live!

Each location can have one of four statuses for each card scheme:

:star: Follow your syncing status using the progress bar:

When your Program is syncing, follow the status on the progress bar where you can follow the current status and estimated finish time.

:woman_shrugging::man_shrugging: What do to if the status of a location is " Failed ?"

If a location has the status " Failed ," the locational data entered was returned as ‘invalid’ by the specified card scheme. This means that the card scheme(s) could not match the given address to a merchant location in their database. This could be for a variety of different reasons. It’s possible the locational information inputted was incorrect or a duplicate MID exists.

If a location does " fail ," please continue with the following steps:

𝟏. Double-check all address information is correct
𝟐. Double-check the merchant brand name is accurate and matches the official registered brand name.
𝟑. If using a Payment Facilitator (such as iZettle, PayPal, Square, Sumup or others), please reach out to your partnering Payment Facilitator and request a unique merchant ID (MID).

Troubleshootung If after completing the steps above the location is still’ failed, ’ a test transaction at the retailer location will need to take place. Once the test transaction has been completed, email with the following information:

  • Fidel CardID (found on the Fidel Dashboard)
  • Transaction amount
  • Date of transaction

The matching process done by the card schemes is unfortunately something Fidel has no control over. However, if you have further questions please reply to this post, or reach out to us at and we’ll always try our best to help! :slight_smile: