Transactions in test environment can now be cleared

When completing a credit card transaction, there are two steps: authorisation and clearing.

  1. Authorisation is the step at purchase where the bank confirms that the purchase can be made.

  2. Clearing is the step 24-72 hours later where the money is actually debited and transferred to the merchant's account.

In the Fidel test environment, all transactions are automatically authorised, and appear in the transactions table of the dashboard. You can now manually "clear" the transaction, to mimic the process where the bank completes the transaction:

Screenshot 2020-06-16 at 15.38.24.png

Once you confirm the transaction clearing, it will appears as cleared:

Screenshot 2020-06-16 at 15.39.44.png

And the transaction.clearing webhook will fire, allowing you to test transaction clearing before going to production.

Refund Transaction Matching

Fidel now offers refund transaction matching. If a transaction refund is made at the same location for the same amount as the original transaction, Fidel will match the two transactions.

The original transaction will gain a new field refundTransactionId that points to the refund transaction.

The refund transaction will point to the original transaction with the originalTransactionId field.

Read more here:

Custom Headers in Webhooks

You can now add custom headers to your Fidel Webhooks.

You'll see it as a new UI option on our dashboard:

Screenshot 2020-06-08 at 10.36.42.png

We describe the header use in our docs:

Read how to implement in our API as well!

Merchant location onboarding improvement

When you add a location to your card linking program, Fidel must perform a "Location Sync" that validates the location with the card networks before transactions can be accepted. In the past, this process has taken 7-10 business days.

We have completely refactored the merchant location onboarding process. Since this refactor, we are seeing greatly reduced location onboarding times. You can now expect your location onboarding with the card network to take 3-4 business days.

Offers API now available in test environment


The Offers API allows you to create online or in-store offers using card-linked technology. Create and manage all of your offers in one place, while personalising them by brand, discount type and amount, days of the week, duration, etc.

Previously the Offers platform was only available for live accounts, but is now available in test environment. You can create test offers with multiple combinations and try offer qualification using the playground to create sample transactions.

Login to the Fidel Dashboard and head to the 'CLO' tab to begin seeing what offers you can build.

You can find documentation at and the API Reference at

If you have any questions, please let us know in the community and we’ll follow up!

Onboard locations with MID

Onboarding locations just got faster. ⚡️

You can now add merchant IDs (MID) when creating locations. Creating locations with MID makes identifying merchant locations more accurate and faster to onboard.

We initially support Mastercard and Visa MIDs. Amex MIDs coming soon.

You can create locations with MIDs on the Fidel Dashboard:


You can also submit MIDs by using the new searchBy object in the Create Location API endpoint.

curl -X POST \{programId}/locations \
  -H 'content-type: application/json' \
  -H 'fidel-key: sk_your_secret_key' \
  -d '{
    "address": "43 Frith Street", 
    "brandId": "838d648e-5614-48a7-8e8b-6b3014638c67", 
    "city": "London", 
    "countryCode": "GBR",
    "postcode": "W1V 5TE",
    "searchBy": {
       "merchantIds": {
          "visa": ["12345678","987654321"],
          "mastercard": ["12345678","987654321"]

You can see the Create Location API Reference here:

If you have any questions, please let us know in the community and we’ll follow up!

iOS SDK v.1.6.1

We have two fixes in one for you today! 🎁

  • iOS SDK can now be used with Xcode 11.2.1 (with Swift 5.1.2).
  • From now on, we don’t accidentally clear metaData between submissions.

If you run into any issues, please let us know in the community and we’ll get right to it!

iOS SDK v1.6.0 – Swift 5.1 & Dark mode

Hi! 👋 Good news: we’ve added Swift 5.1 support to the iOS SDK. As a bonus, it also supports dark mode in iOS 13. 🌘

Check out the docs to get started, or the iOS repo readme for detailed info about supported Swift versions. Happy linking!


React Native SDK v1.2.0

The React Native SDK now supports React Native 0.60+, and can be integrated with CocoaPods.

If you run into any issues, please report on GitHub. Happy linking! 🎉

React Native SDK v1.1.0

We’ve fixed some issues that you have reported on the React Native SDK:

  • Android back button no longer causes the app to crash
  • Typo fixed in countries: sweeden -> sweden.

Thanks for all the feedback, if you run into any further issues, check Issues on the GitHub repo and submit a new one if yours is not there yet! As for the open issues, we’re on it and will be back with more fixes soon.