Fidel API release notes
Fidel API release notes
fidel.uk

Linking a virtual transaction to an active location

 

New

  

Fidel API customers can now link a transaction made on the virtual card to an already active location in addition to those with a not found status.

This allows for the verification of locations onboarded via the standard network search and better troubleshooting.

Transactions can be linked via a dropdown arrow next to the location status.

image1.png

Further details can be found here.

Adding the same offer to multiple programs at once

 

New

  

We’re happy to announce that moving forward customers will be able to add any given Offers Marketplace offer to multiple programs at once. By doing so, we are empowering customers to leverage Offers Marketplace content across programs without reliance on FIDEL API’s Support team, thus enabling faster offer launches.

image.png

Additionally, we’ve made it easier for customers to know which offers are on boarded into each program. Customers are able to more easily edit offers on a program by program basis. For example, setting different start and end dates for the same offer on different programs.

Screenshot 2022-11-04 at 12.01.29.png

Offers targeted at New Customers only

We’re very happy to announce that we’ve just released a new type of offer, with segmentation, to the Offers Marketplace. The first user segmentation criteria we’re launching is based on a cardholder’s spending recency with a given merchant. This type of offer and the associated reward is only eligible for cardholders that haven’t spent at a merchant for a given timeframe determined by the merchant.

The initial batch of these new offers targeting new customers only are already available on the Offers Marketplace, they are easily identifiable by a yellow ‘New Customers’ tag. Feel free to start adding these offers to your programs!

You can also use the GET https://reference.fidel.uk/reference/list-offers endpoint to locate these new offer type which have the data field shown below:

Example:

"items": [
    {
            "contentProvider": {
                "customerRecency": {
                    "days": 90,
                    "enabled": true

As these offers with segmentation are only available to a selection of cardholders, in order to understand which cards are eligible for a given offer at a given time you can call our GET https://api.fidel.uk/v1/offers/{offerId}/cards?segmentation=recency endpoint, with the following segmentation filter ‘?segmentation=recency’. This will return a list of MapIds that will allow you to link back to a specific user profile and manage the visibility of the offer on your UIs.

Screenshot 2022-10-20 at 09.23.36.png

Please keep in mind that with the “New Customer” offers, depending on the length of the recency period, the offers will take some time before you start to see eligible cards. This is because we have to track cards for the duration of the recency period to understand whether they meet the criteria or not.

If you have any questions, suggestions or comments, please reach out to your main point of contact at Fidel API.

Update Card Metadata

You can now update the card metadata object using a new API endpoint. This functionality enables developers to store and update information inside the card object making it easier to associate cards with your users.

Endpoint

PUT https://api.fidel.uk/cards/{cardId}/metadata

Path parameters

  • cardId: String (required)

Body

  • { key: 'value' } (required)


For more details check the API Reference: https://reference.fidel.uk/reference/update-card-metadata.

List Transactions by Card

We just launched a new API endpoint that allows you to list transactions from a specific card. Just like the other list endpoints, it supports pagination and filtering by date.


Endpoint

GET https://api.fidel.uk/v1/cards/{cardId}/transactions

Path parameters

  • cardId: String (required)

Query parameters

  • limit: Number of transactions in the response

  • start: Tells the API where the previous response left off. Use ${encodeURIComponent(JSON.stringify(last))}, where last is the parameter from the previous query.

  • order: Possible values [asc, desc] of datetime date.


For more details, check the API reference: https://reference.fidel.uk/reference/list-transactions-by-card.

As a Publisher, I'm able to edit the start and end date, as well as add metadata to live marketplace offers

Fidel API customers that are using offers from the marketplace are now able to edit the Start and the End date of offers that are live on their programs.

Follow these steps to edit dates:

  1. Go to Offers
  2. Then Live
  3. Click on the specific Marketplace offer
  4. Click Edit
  5. Scroll to editable fields
  6. Edit the start and/or end dates
  7. Click Done

ezgif.com-gif-maker (2).gif

Things to be mindful of:

Start date:

  • The new start date has to be set to a later date than the start date set by the provider or the current date

  • As content providers are free to change the start date at any time, if a new start date is set, it will overrides any changes made by the customer if the new start date from provider is moved to a later date

End date:

  • The new end date can’t be set to a later date than the end date set by the provider, and has to be set to a later date than the current date

  • As content providers are free to change the end date at any time, if a new end date is set, it will overrides any changes made by the customer if the new end date from provider is moved to an earlier date

  • The system will automatically off board locations upon expiration of the offer on the newly set end date

Fidel API customers are now also able to add metadata to offers originating from the Offers marketplace:

  1. Go to Offers
  2. Then Live
  3. Click on the specific Marketplace offer
  4. Click Edit
  5. Scroll to editable fields
  6. Add metadata
  7. Click Done

ezgif.com-gif-maker (1).gif

New Transaction feature 💳

Starting from version 2022-07-13 we can now identify if a transaction was made online or in-store using the cardPresent property of the transaction object.

You can check the payload of the transaction at https://fidelapi.com/docs/transactions/#transaction-object.

📢 New: Add Amex SE Numbers

You can now add an Amex Service Establishment (SE) Number directly to a location via the Fidel API dashboard or the API. Fidel API customers already had the ability to add Merchant IDs for Visa and MasterCard, and this update will enable them to do the same for American Express. 🚀

SE Numbers are used to identify a merchant accepting American Express cards. Adding SE numbers during the location creation process helps to streamline and speed up the onboarding process. Fidel API customers can also use Amex SE Numbers to enhance location accuracy and support an even more reliable dataset.

Merchants can locate American Express SE Numbers on Amex invoices or on the merchant copy of the receipt.

See how it works in this short clip:

Amex SearchBy.gif

You can find the complete documentation at https://reference.fidel.uk/reference/create-location and https://reference.fidel.uk/reference/update-location.

New Reimbursement features! 🤩

We are excited to announce that Reimbursement has expanded with two new features 🚀

Reimbursement by Card

You can now find eligible card transactions for reimbursement. Select the reimbursement amount and get all the cardholder eligible transactions sorted by their amount and date.

reimburse-card.gif

Offers automated Reimbursements

Use the Offers product to enable automated reimbursements, as an alternative to building your own customised integration with the reimbursement product.

offers-automatic-reimbursement.gif

We are currently working on bringing Reimbursement to other countries. Get in touch if you are interested and are not operating in the US.

You can find the complete documentation at https://fidel.uk/docs/reimbursement and the API Reference at https://reference.fidel.uk/reference#create-reimbursement.

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

New Reimbursement API launched in the US! 🇺🇸

We are excited to announce that our new Reimbursement API is now available in the US with Visa© and Mastercard©.

The Reimbursement API allows you to improve the customer experience by reimbursing cash directly onto linked cards, eliminating the need for you to handle other personal identifiable data, such as bank account.

reimbursing.gif

How can you start using Reimbursement?

  • Current US accounts will be prompted in the Fidel Dashboard to activate the Reimbursement product using the latest API version 2021-09-28. You can read more information on the new version release here. reimbursement-activation.gif

  • New US accounts will already be using the new API version and no action is required.

We are currently working on bringing Reimbursement to other countries. Get in touch if you are interested and are not operating in the US.

You can find the complete documentation at https://fidel.uk/docs/reimbursement and the API Reference at https://reference.fidel.uk/reference#create-reimbursement.

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