Enrichment V1 (Deprecated)

In a world overwhelmed with data, understanding the essence and application of data enrichment is non-negotiable for teams and decision-makers. Data enrichment, including database enrichment, is a process that enhances, refines, and improves raw data, making it a more valuable asset for decision-making. It's about using the right tools to enrich the data, providing deeper insights and clarity. Whether it's for businesses looking to understand their customers better or financial institutions aiming to offer more personalized services, data enrichment acts as the key to unlocking complex data and transforming it into actionable information.

Lune's Data API function is to simplify financial data for businesses, offering a transformative approach to managing and interpreting transaction data, a key aspect of transaction data enrichment. The way it works is that the API serves as a bridge, connecting raw transactional information that's hard to understand for regular teams and end-consumers to a world of enriched, meaningful insights.

Here’s how it works - Let's start with the integration process, the API is designed for ease of integration, enabling businesses, particularly banks and fintech companies, to quickly harness its power to enrich the data. So, this means internal teams don't have to pour much time into the integration process, most of the heavy-duty work is going to betaken care of by Lune's team. With the integration, Lune's Data API will provide immediate enrichment of transaction data, categorizing and sub-categorizing each transaction, attaching brand names and logos, and even assessing the carbon footprint of transactions. Banks and FinTechs find this valuable, as it gives them a clearer picture of how their customers are spending.

But what does this mean in the real world, especially from a banking consumer's perspective? Let's consider a simple example: a customer buys a cinema ticket. In typical bank statements, transactions might appear as a cryptic entry like "Wafi1307X", perhaps showing a mall name and a bunch of non-understandable codes. With Lune, the same transaction is transformed. It clearly shows as a purchase at"Vox Cinema", complete with the brand's logo, the date and time of the transaction, the city, the amount spent, and an identifiable lifestyle icon. Which improves the user experience, turning their financial transactions into something more transparent and understandable.

The beauty of Lune's API lies in its real-time functionality. businesses or end customers wouldn't need to wait to view enriched results, transactions are enriched instantaneously, so users could view everything in real-time.

We understand how crucial it is for financial institutions to keep their data secure and their operations flawless. That's why we've taken it upon ourselves to design our enrichment engine to be optimized for quick integration and equipped it with bank-grade security. This means businesses can start using our solutions without lengthy setup processes or any security concerns. We're also ISO 27001 certified, reassuring our partners of our commitment to safety and privacy.

Enrich Single Transaction

Enriches single transaction

AUTHORIZATIONS:

Api-key

REQUEST BODY SCHEMA :

application/json

raw_description
required

string (Raw Description)

amount
required

float (Amount) >=1.0

Responses

RESPONSE SCHEMA :

application/json

brand_logo

string (Brand Logo URL)
The brand logo is concatenated with https://api.lunedata.io/media to get the actual image.

category_name

string (See All Categories)

brand_name

string (Brand Name)

category_id

string (See All Categories) [ 1 .. 255 ] charcters

brand_id

string (Brand ID is a unique identifier) [ 1 .. 255 ] charcters

POST

https://api.lunedata.io/api/v1/transaction/enrich/

Payload

application/json

Content type

{
  "raw_description": "string",
  "amount": 1
}

201

application/json

Content type

{
  "brand_logo": "string",
  "category_name": "string",
  "brand_name": "string",
  "category_id": "string",
  "brand_id": "string"
}

Enrich Bulk Transaction

Enriches the transactions in bulk

AUTHORIZATIONS:

Api-key

REQUEST BODY SCHEMA :

application/json

data >
required

Array of objects (Bulk Transaction Objects) [ items ]

Array [

local_id
‍required

string (Local ID is used to identify the transactions) [ 1 .. 36 ] charcters

raw_description
‍required

string (Raw Description)

amount
required

float (Amount) >=1.0

]

Responses

RESPONSE SCHEMA :

application/json

Array [

local_id

string (Local ID is used to identify the transactions) [ 1 .. 36 ] charcters

global_tx_id

string (Global transaction ID) [ 1 .. 36 ] charcters

category_id

string (See All Categories) [ 1 .. 255 ] charcters

cagtegory_name

string (See All Categories)

brand_id

string (Brand ID is a unique identifier) [ 1 .. 255 ] charcters

brand_name

string (Brand Name)

brand_logo

string (Brand Logo URL)
The brand logo is concatenated with https://api.lunedata.io/media to get the actual image.

]

POST

https://api.lunedata.io/api/v1/transaction/enrich/bulk/

Payload

application/json

Content type

{
  "data": [
    {
      "local_id": "string",
      "raw_description": "string",
      "amount": 1
    }
  ]
}

201

application/json

Content type

[
  {
    "local_id": "string",
    "global_tx_id": "string",
    "category_id": "string",
    "category_name": "string",
    "brand_id": "string",
    "brand_name": "string",
    "brand_logo": "string"
  }
]

Transaction Enrichment Benefits

Transaction enrichment through Lune's Data API offers practical benefits that directly improve the day-to-day financial experiences of both businesses and their customers. Here are some benefits of transaction data enrichment that our partners should expect when onboarding with Lune:
‍
1) Clearer Financial Statements for Customers: The direct benefit of transaction enrichment our partners get is in the clarity it brings to customers' financial statements. By replacing cryptic transaction entries with clear, understandable information, customers gain an immediate, in-depth understanding of their spending. Now, customers see straightforward details like 'Vox Cinema' or "Starbucks" instead of confusing codes, making it easier to understand and manage their spending.

2) Simplified Expense Tracking: As part of Lune’s comprehensive transaction data services, its enrichment features, like categorization and sub-categorization of transactions, help simplify budgeting and spending analysis. Everyday banking users can easily track their expenses in a more organized manner, paving the way for more informed financial decisions.

3) Stronger Security and Privacy: Given the sensitive nature of financial data, the need for bank-grade security measures is non-negotiable. We're securing transactions with an advanced TLS encryption technology, and we're also ISO 27001 certified ensuring security and privacy.

4) Real-Time Insights: In a financial context where timing can be important, Lune's API empowers businesses and end-users to get instant access to real-time data enrichment.

5) Boosting User Engagement: Financial data can be complex, but Lune changes that. By making transaction details more relatable and understandable, it naturally leads to increased user engagement. Customers are more likely to interact with financial services that they find useful and easy to navigate.

6) Tailored Financial Solutions: For banks and fintechs, the enriched data provided by Lune opens up opportunities for offering customized financial products and services. Understanding customer spending habits in detail allows these institutions to create solutions that genuinely match user needs and preferences.

‍

Enrichment V2.1.2

The Enrichment V2 endpoint, Accepts a query parameter response-type that allows you to control response type from either consumer or business. It also returns the Brand Website URL, Business Category and Business Sub-category for transactions. Transactions can be sent as single or bulk requests using the same endpoint. Note that in case of not specifying response-type the consumer param value will be set by default.

Query Params (Key)

Value

response-type

consumer

Enriching Consumer Transactions

Enriches single or bulk transactions

AUTHORIZATIONS:

Api-key

REQUEST BODY SCHEMA :

application/json

transactions >
required

Array of objects (Bulk Transaction Objects) [ items ]

Array [

amount
‍required

float (Amount)

iso_currency_cd
‍required

string (ISO 4217 code)

raw_description
‍required

string (Raw Description)

transaction_date
‍required

string (YYYY-MM-DD)

mcc

integer (MCC code)

transactionid
‍required

string (characters & numbers)

iso_country_cd

string (ISO 3166: A-3)

city

string (Any)

location

object (
{
"latitude": float,
"longitude": float
}
)

counter_party_name

string (characters & numbers)

direction
‍required

string (IN/OUT)

transaction_type

string (transaction type detail)

transaction_purpose

string (transaction purpose detail)

is_online_purchase

boolean (true/false)

is_reversal

boolean (true/false)

is_salary_deposit

boolean (true/false)

is_tax_related

boolean (true/false)

is_transfer_to_investment

boolean (true/false)

is_transfer_to_savings

boolean (true/false)

is_atm_on_us

boolean (true/false)

is_installment

boolean (true/false)

is_overdraft_protection

boolean (true/false)

]

Responses

RESPONSE SCHEMA :

application/json

transactions >

Array of objects (Bulk Transaction Objects) [ items ]

Array [

ref_id

string (Reference ID)

category_id

string (See All Main Consumer Categories) [ 1 .. 255 ] charcters

category_name

string (See All Main Consumer Categories)

sub_category_id

string (See All Consumer Sub-Categories) [ 1 .. 255 ] charcters

sub_category_name

string (See All Consumer Sub-Categories)

brand_id

string (Brand ID is a unique identifier) [ 1 .. 255 ] charcters

brand_name

string (Brand Name)

brand_logo

The brand logo is concatenated with https://api.lunedata.io/media to get the actual image.

brand_url

string (Brand website URL)

global_tx_id

string (Global Transaction ID)

]

POST

https://api.lunedata.io/api/v2/transaction/enrich/?response-type=consumer

Payload

application/json

Content type

{
    "transactions" : [
       {
          "amount": 25.99,
          "iso_currency_cd": "AED",
          "raw_description": "McDonald's Purchase : 123 4567 890123 DUBAI MALL DUBAI AED 25.99",
          "transaction_date": "2022-04-10",
          "mcc": 5814,
          "transactionid": "TRANS00003",
          "iso_country_cd": "ARE",
          "city": "Dubai",
          "location": {
            "latitude": 25.2048,
            "longitude": 55.2708
          },
          "counter_party_name": "McDonald's",
          "direction": "OUT",
          "transaction_type": "Purchase",
          "transaction_purpose": "Food",
          "is_online_purchase": false,
          "is_reversal": false,
          "is_salary_deposit": false,
          "is_tax_related": false,
          "is_transfer_to_investment": false,
          "is_transfer_to_savings": false,
          "is_atm_on_us": false,
          "is_installment": false,
          "is_overdraft_protection": false
      },
      {
          "amount": 35.50,
          "iso_currency_cd": "AED",
          "raw_description": "McDonald's Purchase : 456 78XX ABU DHABI MALL ABU DHABI AED 35.50",
          "transaction_date": "2022-04-15",
          "mcc": 5814,
          "transactionid": "TRANS00004",
          "iso_country_cd": "ARE",
          "city": "Abu Dhabi",
          "location": {
            "latitude": 24.4539,
            "longitude": 54.3773
          },
          "counter_party_name": "McDonald's",
          "direction": "OUT",
          "transaction_type": "Purchase",
          "transaction_purpose": "Food",
          "is_online_purchase": true,
          "is_reversal": true,
          "is_salary_deposit": false,
          "is_tax_related": true,
          "is_transfer_to_investment": false,
          "is_transfer_to_savings": false,
          "is_atm_on_us": false,
          "is_installment": false,
          "is_overdraft_protection": false
      }
    ]
}

201

application/json

Content type

{
    "transactions": [
        {
            "ref_id": "r1",
            "category_id": "10",
            "category_name": "Dining",
            "sub_category_id": "10-1",
            "sub_category_name": "Restaurants",
            "brand_id": 20157,
            "brand_name": "McDonalds",
            "brand_logo": "brand_logos/mcdonalds.png",
            "brand_url": "https://www.mcdonalds.com/",
            "global_tx_id": "9c838349-ce82-4c20-83d6-7fff6b3a5958"
        },
        {
            "ref_id": "r2",
            "category_id": "10",
            "category_name": "Dining",
            "sub_category_id": "10-1",
            "sub_category_name": "Restaurants",
            "brand_id": 20157,
            "brand_name": "McDonalds",
            "brand_logo": "brand_logos/mcdonalds.png",
            "brand_url": "https://www.mcdonalds.com/",
            "global_tx_id": "59f3c13a-139a-47c4-9414-28913a69b50d"
        }
    ]
}

Enriching Business Transactions

Query Params (Key)

Value

response-type

business

Enriches single or bulk transactions

AUTHORIZATIONS:

Api-key

REQUEST BODY SCHEMA :

application/json

transactions >
required

Array of objects (Bulk Transaction Objects) [ items ]

Array [

amount
‍required

float (Amount)

iso_currency_cd
‍required

string (ISO 4217 code)

raw_description
‍required

string (Raw Description)

transaction_date
‍required

string (YYYY-MM-DD)

mcc

integer (MCC code)

transactionid
‍required

string (characters & numbers)

iso_country_cd

string (ISO 3166: A-3)

city

string (Any)

location

object (
{
"latitude": float,
"longitude": float
}
)

counter_party_name

string (characters & numbers)

direction
‍required

string (IN/OUT)

transaction_type

string (transaction type detail)

transaction_purpose

string (transaction purpose detail)

is_online_purchase

boolean (true/false)

is_reversal

boolean (true/false)

is_salary_deposit

boolean (true/false)

is_tax_related

boolean (true/false)

is_transfer_to_investment

boolean (true/false)

is_transfer_to_savings

boolean (true/false)

is_atm_on_us

boolean (true/false)

is_installment

boolean (true/false)

is_overdraft_protection

boolean (true/false)

]

Responses

RESPONSE SCHEMA :

application/json

transactions >

Array of objects (Bulk Transaction Objects) [ items ]

Array [

ref_id

string (Reference ID)

business_category_id

string (See All Business Main Categories) [ 1 .. 255 ] charcters

business_category_name

string (See All Business Main Categories)

business_sub_category_id

string (See All Business Sub-Categories) [ 1 .. 255 ] charcters

business_sub_category_name

string (See All Business Sub-Categories)

brand_id

Integer (Brand ID is a unique identifier)

brand_name

string (Brand Name)

brand_logo

The brand logo is concatenated with https://api.lunedata.io/media to get the actual image.

brand_url

string (Brand website URL)

global_tx_id

string (Global Transaction ID)

]

POST

https://api.lunedata.io/api/v2/transaction/enrich/?response-type=business

Payload

application/json

Content type

{
    "transactions" : [
       {
          "amount": 25.99,
          "iso_currency_cd": "AED",
          "raw_description": "McDonald's Purchase : 123 4567 890123 DUBAI MALL DUBAI AED 25.99",
          "transaction_date": "2022-04-10",
          "mcc": 5814,
          "transactionid": "TRANS00003",
          "iso_country_cd": "ARE",
          "city": "Dubai",
          "location": {
            "latitude": 25.2048,
            "longitude": 55.2708
          },
          "counter_party_name": "McDonald's",
          "direction": "OUT",
          "transaction_type": "Purchase",
          "transaction_purpose": "Food",
          "is_online_purchase": false,
          "is_reversal": false,
          "is_salary_deposit": false,
          "is_tax_related": false,
          "is_transfer_to_investment": false,
          "is_transfer_to_savings": false,
          "is_atm_on_us": false,
          "is_installment": false,
          "is_overdraft_protection": false
      },
      {
          "amount": 35.50,
          "iso_currency_cd": "AED",
          "raw_description": "McDonald's Purchase : 456 78XX ABU DHABI MALL ABU DHABI AED 35.50",
          "transaction_date": "2022-04-15",
          "mcc": 5814,
          "transactionid": "TRANS00004",
          "iso_country_cd": "ARE",
          "city": "Abu Dhabi",
          "location": {
            "latitude": 24.4539,
            "longitude": 54.3773
          },
          "counter_party_name": "McDonald's",
          "direction": "OUT",
          "transaction_type": "Purchase",
          "transaction_purpose": "Food",
          "is_online_purchase": true,
          "is_reversal": true,
          "is_salary_deposit": false,
          "is_tax_related": true,
          "is_transfer_to_investment": false,
          "is_transfer_to_savings": false,
          "is_atm_on_us": false,
          "is_installment": false,
          "is_overdraft_protection": false
      }
    ]
}

201

application/json

Content type

{
    "transactions": [
        {
            "ref_id": "r1",
            "business_category_id": "B8",
            "business_category_name": "Meals & drinks",
            "business_sub_category_id": "B8-1",
            "business_sub_category_name": "Restaurants",
            "brand_id": 20157,
            "brand_name": "McDonalds",
            "brand_logo": "brand_logos/mcdonalds.png",
            "brand_url": "https://www.mcdonalds.com/",
            "global_tx_id": "37ce3c54-77eb-4d0a-baa0-65d78075b5a4"
        },
        {
            "ref_id": "r2",
            "business_category_id": "B8",
            "business_category_name": "Meals & drinks",
            "business_sub_category_id": "B8-1",
            "business_sub_category_name": "Restaurants",
            "brand_id": 20157,
            "brand_name": "McDonalds",
            "brand_logo": "brand_logos/mcdonalds.png",
            "brand_url": "https://www.mcdonalds.com/",
            "global_tx_id": "2d76dc98-3869-4d5f-81d9-3b1660a6f104"
        }
    ]
}

Response Status

- 200 Success : Standard response for successful HTTP requests.

- 400 Bad Request: The request cannot be fulfilled due to bad syntax.

Data Enrichment Services

Lune stands out in this arena by providing a range of data enrichment services that cater to different needs within the financial sector. Each service is designed to unlock new layers of understanding, aiding businesses in making more informed decisions and offering better services to their customers.

1) B2B Enrichment: Lune’s B2B data enrichment service is for businesses looking for a deeper understanding of their corporate clients. It excels in illuminating transaction patterns and financial behaviours through B2B data enrichment, enabling companies to fine-tune their offerings. For businesses, the insights gained from Lune’s B2B data enrichment could mean enhanced client relationships and guiding their businesses in developing services that precisely align with their corporate clients' needs.
‍
2)Financial Enrichment: The core objective of this service is achieving financial data enrichment, and making sense of consumer financial data. The financial enrichment service takes the jargon-filled world of transaction data and turns it into clear, easy-to-follow insights. Banks and fintechs find this invaluable for understanding their customers’ spending habits, allowing them to provide personalized financial advice and tailor-made products.

3) Lead Enrichment: Lune's lead enrichment service focuses on enhancing marketing and sales efforts. By enriching lead data, businesses can better understand their potential customers, including their financial preferences and needs which in return allows for more targeted and effective marketing strategies, increasing the chances of converting leads into loyal customers.

Comprehensive Solutions with LuneData: LuneData revolutionizes financial data management by offering streamlined, impactful solutions, including advanced database enrichment techniques, to bring a new level of clarity and usability to financial data. Here's how LuneData excels in transaction data enrichment:

1)Centralized Financial Data Management: LuneData merges different financial data elements into a single platform, cutting out the clutter of multiple tools and streamlining data management to be more efficient and straightforward for users.

2) Customization for Varied Needs: LuneData's platform stands out in transaction data services for its flexibility and adaptability to meet the unique needs of any business, big or small. We make sure our partners get customized data solutions that are relevant and effective.

3) Insight-Driven Decision Making: The platform gives businesses the power to make sharper strategic moves with actionable insights pulled from enriched data. This helps our partners stay ahead when it comes to customer experience.

4) Elevated End-User Experience: LuneData prioritizes the end user, enhancing their financial data interaction. This focus leads to increased engagement, trust, and satisfaction, strengthening the relationship between financial service providers and customers.
‍
‍

List Of Consumer Main Categories

category_id (string)

category_name (string)

"1"

Financial Services

"2"

Charity & Gifts

"3"

Education

"4"

Entertainment

"5"

Government Services

"6"

Groceries

"7"

Wellness

"8"

Savings & Investments

"9"

Household

"10"

Dining

"11"

Shopping

"12"

Income

"13"

Transfer

"14"

Transportation

"15"

Travel

"16"

Loans

"17"

Insurance

"18"

Services

"19"

Miscellaneous

List of emirates

code (string)

name

AE-AZ

Abu Dhabi

AE-FU

Fujairah

AE-SH

Sharjah

AE-DU

Dubai

AE-RK

Ras Al Khaimah

AE-UQ

Umm Al Quwain

AE-AJ

Ajman

List Of Consumer Sub-Categories

sub_category_id (string)

sub_category_name (string)

Financial Services

"1-1"

Currency Exchange

"1-2"

Bank Fees

"1-3"

Financial Services

"1"

Other

Charity & Gifts

"2-1"

Donations

"2-2"

Gifting

"2"

Other

Education

"3-1"

University Tuition

"3-2"

School Fees

"3-3"

Books

"3-4"

Courses

"3-5"

Certifications

"3"

Other

Entertainment

"4-1"

Cinema

"4-2"

Theater

"4-3"

Concerts

"4-4"

Sport Events

"4-5"

Amusement Parks

"4-6"

Sport Activities

"4-7"

Comedy Shows

"4-8"

Pets

"4-9"

Gaming

"4-10"

Hobbies

"4-11"

Music Streaming

"4-12"

TV

"4-13"

Movie Streaming

"4-14"

Parks

"4"

Other

Government Services

"5-1"

Taxes

"5-2"

Government Fees

"5"

Other

Groceries

"6-1"

Supermarket

"6-2"

Convenience Store

"6-3"

Alcohol Shop

"6-4"

Tobacco Shop

"6-5"

Grocery Delivery

"6"

Other

Wellness

"7-1"

Medical

"7-2"

Pharmacy

"7-3"

GYM

"7-4"

Hair & Beauty

"7-5"

Dental

"7-6"

Mental Wellbeing

"7"

Other

Savings & Investments

"8-1"

Savings

"8-2"