From 33c8ab14e151ed2a58ec85186888442c2ad3e930 Mon Sep 17 00:00:00 2001 From: Ricardo Xavier Date: Tue, 4 Aug 2026 10:18:02 +0100 Subject: [PATCH 1/2] docs: add transaction descriptor --- select/transactions.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/select/transactions.md b/select/transactions.md index 2fdfbd6..97e8e9e 100755 --- a/select/transactions.md +++ b/select/transactions.md @@ -27,6 +27,9 @@ One transaction event occurs at authorisation time. The other transaction event | `created` | The time when the transaction object was created in the Fidel API database. | string, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format | | `currency` | The currency of the purchase. | string, alpha code format of [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) | | `datetime` | The time of the transaction (local time of the merchant). | string, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format | +| `descriptor` | The merchant and store descriptor information provided by the card network. | object | +| `descriptor.merchantName` | The merchant name provided by the card network. | string (or null) | +| `descriptor.storeName` | The store name provided by the card network. | string (or null) | | `id` | The unique identifier of the transaction. | string | | `identifiers` | See the definition of the identifiers object below. | object | | `location.address` | The street address of the location where the purchase was made. | string | @@ -73,6 +76,10 @@ fileName:transaction.json "created": "2019-04-09T16:00:00.644Z", "currency": "GBP", "datetime": "2019-04-10T15:59:30", + "descriptor": { + "merchantName": "Coffee Brand London", + "storeName": "Coffee Brand" + }, "programId": "6e38aa0c-b7ef-46bd-b1bd-c07c647d9cba", "refundTransactionId": null, "updated": "2019-04-09T16:00:00.644Z", From e813f9985ede679f8a5e46e417195b9cc26be9f3 Mon Sep 17 00:00:00 2001 From: Ricardo Xavier Date: Tue, 4 Aug 2026 10:21:21 +0100 Subject: [PATCH 2/2] docs: add descriptors to webhook examples --- select/webhooks.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/select/webhooks.md b/select/webhooks.md index b63eb2e..f7e6c81 100755 --- a/select/webhooks.md +++ b/select/webhooks.md @@ -299,6 +299,10 @@ fileName:transaction.auth "cleared": false, "amount": 100, "currency": "GBP", + "descriptor": { + "merchantName": "Bob's Cafe London", + "storeName": "Bob's Cafe" + }, "wallet": null, "card": { "id": "bc538b71-31c5-4699-840a-6d4a08693314", @@ -363,6 +367,10 @@ fileName:transaction.clearing "updated": "2020-07-08T17:20:44.134Z", "programId": "06471dbe-a3c7-429e-8a18-16dc97e5cf35", "datetime": "2020-07-08T18:05:52", + "descriptor": { + "merchantName": "Bob's Cafe Bristol", + "storeName": "Bob's Cafe" + }, "card": { "id": "62744670-f935-4ba3-8e89-be23e31292cf", "firstNumbers": "444400", @@ -406,6 +414,10 @@ fileName:transaction.refund "authCode": "A73H890", "originalTransactionId": "8bbbf56b-3819-473b-877d-cf2175f268f4", "currency": "GBP", + "descriptor": { + "merchantName": "Bob's Cafe Bristol", + "storeName": "Bob's Cafe" + }, "id": "5ec08ca8-38c6-42e1-9fa5-32c67e4135b2", "amount": -10, "wallet": null, @@ -491,6 +503,10 @@ This means that partial refunds will not be identified as the cashback amount is "auth": false, "authCode": "A73H890", "currency": "GBP", + "descriptor": { + "merchantName": "Bob's Cafe Bristol", + "storeName": "Bob's Cafe" + }, "id": "5ec08ca8-38c6-42e1-9fa5-32c67e4135b2", "amount": -10, "wallet": null,