Enrich Transactions

Version 3

Lune's API Version 3 is a comprehensive update focusing on enhancing data enrichment and localization, offering users a more detailed and accurate view of their financial transactions.

Arabic Localization
Version 3 introduces Arabic localization, a significant enhancement that allows for Arabic brands, categories and subcategories to be displayed in Arabic letters, providing a seamless user experience for users in Arabic countries and the Middle East. This update improves the accessibility of the API and enhances the user experience by integrating Arabic brands into the interface, making it easier for users to navigate and understand the information presented. By including Arabic brands, Lune's API Version 3 demonstrates cultural sensitivity and inclusivity, catering to the language preferences of its diverse user base in the region.

Categories & Subcategories
Lune's API Version 3 introduces 100+ unique categories and subcategories for consumer and business transactions, aiming to enhance categorization and user experience. This update provides more relevant and descriptive categorization, allowing for a better understanding of financial activities. With improved categorization, users can gain enhanced insights into their spending habits and receive customized recommendations for managing their finances more effectively.

Webhook Functionality
The webhook functionality enables constant automated updates to the enriched data displayed to clients as it is updated in Lune's database. It also allows Lune to update their customers database based on customer feedback reported on the client portal.

Carbon Footprint Integration
Lune is a proud partner of Connect Earth, a UK & UAE based Carbon Measurement API Company. Founded on the principle that actionable carbon data should be accessible to all, Connect Earth’s data models and intelligence offer financial institutions and their customers an opportunity to optimize emission measurement. They currently operate in the UAE, UK,EU, LATAM and North America. This would empower customers with the insights they need to make informed choices and achieve a financially and environmentally sustainable future.

Post

{{host}}/api/v3/transaction/enrich?response-type=consumer

Request Headers:

Request Body Parameters:

Request Payload Sample:

{
   "transactions" : [
        {
           "customer_id" : "vaxfukrv81",
           "account_id" : "42g4zyyrdppu",
           "card_id" : "zucyl1usngf51yc1",
           "merchant_name": "Anghami",
           "transaction_id": "1234",
           "amount": 120,
           "iso_currency_cd": "AED",
           "occurred_at": "2024-10-20",
           "mcc": "3781",
           "raw_description": "Anghami Plus Monthly Plan, AED 120, Dubai",
           "merchant_id": "1234567890",
           "location": {
               "iso_country_cd": "ARE",
               "city": "Dubai",
               "address": "street 123",
               "region": "gst",
               "postal_code": "12345"
           }
        }
   ]
}

Response Schema:

Response sample:

{
   "success": true,
   "message": "",
   "data": [
       {
           "brand_id": 9844,
           "brand_name": "Anghami",
           "brand_logo": "brand_logos/Anghami_United Arab Emirates.png",
           "global_tx_id": "1737435b-ce00-493d-8177-015f4d9e61d8",
           "brand_name_ar": "أنغامي",
           "brand_url": "https://www.anghami.com/",
           "category_id": "4",
           "category_name": "Entertainment",
           "category_name_ar": "الترفيه",
           "sub_category_id": "3-4",
           "sub_category_name": "Music Streaming",
           "sub_category_name_ar": "الموسيقى",
           "carbon_emission": 7.817279999999999,
           "recurring": false,
           "ref_id": null
       }
   ]
}