API Version Headers

versioning.png

Hello! πŸ‘‹πŸΌ

In order to migrate to a newer version of the API you can now use a custom HTTP header specifying the API version you would like to request. This allows you to stay on an earlier version and test your development environments against new versions and upgrade when ready.

The Fidel-Version header allows you define in each request the version of the endpoint output. It is possible to request the current version or newer versions of the API.

Check the API changelog at https://reference.fidel.uk/docs/changelog for more information about available versions and go to https://dashboard.fidel.uk/account to upgrade to a newer version.

React Native SDK

We’ve released a React Native bridge so that you can now use native mobile SDKs in React Native apps. If you’re using the web SDK in web view, it’s a good time to make the switch! You'll get to use native mobile capabilities such as card scanning. Check out the docs to get started!

rn-sdk.gif

New Transaction Object πŸ’³

We've made some updates to the transaction object schema so you can easily access more data in your card-linked application without additional API requests. 🎯

The object is now organised in a nested structure. It includes new data points and nested objects are expanded by default.

Note that this is a breaking change from previous versions. Please review the changes below to update your applications.

To update to the new 2019-03-05 API version, go to your account page in the dashboard and click Upgrade Available.

{
  "id": "7fdfd5d8-9589-402f-8477-4a727ad138a2",
  "accountId": "4ed4b72b-aa4c-43a1-8054-da6d1368e17a",
  "amount": 100,
  "auth": true,
  "cleared": false,
  "created": "2019-04-09T16:00:00.644Z",
  "currency": "GBP",
  "datetime": "2019-04-10T15:59:30",
  "offer": null,
  "programId": "6e38aa0c-b7ef-46bd-b1bd-c07c647d9cba",
  "updated": "2019-04-09T16:00:00.644Z",
  "wallet": "apple-pay",
  "brand": {
    "id": "9d136f2e-df99-4a08-a0a5-3bc1534b7db8",
    "logoUrl": "https://coffeebrand.com/logo.png",
    "name": "Coffee Brand"
  },
  "card": {
    "id": "bc538b71-31c5-4699-820a-6d4a08693314",
    "firstNumbers": "555500",
    "lastNumbers": "5001",
    "scheme": "visa",
    "metadata": {
      "id": "00012345",
      "name": "Joseph Cooper"
    }
  },
  "identifiers": {
    "amexApprovalCode": "A9M5VYD",
    "mastercardRefNumber": "H6REF8BL",
    "mastercardTransactionSequenceNumber": "000009867889",
    "MID": "8552067328",
    "visaAuthCode": "A73H890"
  },
  "location": {
    "id": "7a916fbd-70a0-462f-8dbc-bd7dbfbea140",
    "address": "53 Frith Street",
    "city": "London",
    "countryCode": "GBR",
    "postcode": "W1D 4SN",
    "timezone": "Europe/London",
    "geolocation": {
      "latitude": 51.513716,
      "longitude": -0.13202
    },
    "metadata": {
      "id": "0001234567",
      "name": "Coffee Brand HQ"
    }
  }
}

New

"brand": { }
"card": { }
"datetime":
"identifiers": { }
"location": { }
  • brand is an object and it contains the following properties of the brand object: id, name, logoURL, metadata:{}
  • card is an object and it contains the following properties of the card object: id, firstNumbers, lastNumbers, scheme, metadata:{}
  • datetime replaces the date and time properties and represents the local date and time where the transaction took place without timezone information.
  • identifiers is an object and it contains the following scheme specific unique transaction identifiers: amexApprovalCode, mastercardRefNumber, mastercardTransactionSequenceNumber, MID, visaAuthCode
  • location is an object and it contains the following properties of the location object: id, address, city, postCode, countryCode, timezone, geolocation: {}, metadata:{}

Removed

"date":
"live":
"merchantId":
"time":

This update affects the following resources:

Endpoints:

  • transactions/{transactionsId}
  • brand/{brandId}/transactions
  • program/{programId}/transactions

Webhooks:

  • transaction.auth
  • transaction.auth.qualified
  • transaction.clearing
  • transaction.clearing.qualified

The new identifiers will power a new range of use cases, timezone will help you understand local transaction time, while new geolocation property maps exactly where the transaction took place.

For more details please check out the documentation at https://docs.fidel.uk/transactions.

Get in touch with support@fidel.uk if you have any questions.

Auto-approve brand consent βœ…

auto-approve-consent

The most requested feature of the year...so far! πŸ™πŸΌ

If you're funding your own offers, or you've received direct authorisation from a brand, you can now auto-approve the brand's consent when you create a new brand on the dashboard or using the API by setting the following property when creating a Brand User:

skipInvite: true

Check API Reference here πŸ‘ˆπŸΌ

Happy days! πŸ™Œ

Card Linked Offers API 🎁

Today, we announce a brand new Offers API. It's available to all our live accounts!

Card linked offers allow you to qualify transactions based on amount, days of the week, minimum spend, etc.

You can use the API to:

  • Create offer
  • Get offer
  • Delete offer
  • Link locations to offer
  • Email offer to Brand

For more detailed info check the Documentation and the Offers API Reference.

If you have any questions please contact our main CLO man tim@fidel.uk.

Delete locations πŸ—‘

ezgif.com-video-to-gif.gif

We heard your feedback loud and clear! You can now delete locations on the dashboard or using the API.

Screenshot 2019-03-06 at 16.47.14.png

Just make sure once deleted, you re-sync the program to complete the process. After a sync is completed, all deleted locations will disappear from the dashboard. And voila, you’re good to go!

We've added support for Amex πŸ’³

trinity.png

More card types = more choice for your users, and an even more rewarding shopping experience. Now your customers will be able to collect rewards when they use their Amex card!

Today we're thrilled to announce that we have added support for Amex transactions in the UK, with the Nordics and North America to follow shortly. This makes Fidel the only global API partner to support all three major payment card types...the Holy Trinity!

Read the rest of the announcement here

We've got Release Notes!

Huge news! πŸŽ‰ We've started publishing our product updates in a public changelog so you're always up-to-date! Keep an eye on this page for new features, bug fixes and improvements that are made in the Fidel API platform, applications and services.

You can always get in touch with us on Slack or by emailing support@fidel.uk.

No published changelogs yet.

Surely Fidel API will start publishing changelogs very soon.

Check out our other public changelogs: Buffer, Mention, Respond by Buffer, JSFiddle, Olark, Droplr, Piwik Pro, Prott, Ustream, ViralSweep, StartupThreads, Userlike, Unixstickers, Survicate, Envoy, Gmelius, CodeTree