Configuration Guide
Transaction file configuration is used to process Merchants file of transactions. It tells the system how to handle, validate, and transform the data before saving it to the database.
Configuring on Juspay Dashboard
Configuration Breakdown:
1. Global Configuration
Used to add or override columns such as Transaction status and Merchant ID. If all transactions belong to the same merchant, this configuration ensures consistency across all records.
What it does:
Automatically adds or overrides fields, for example:
txn_statusis set to "SUCCESS" for every rowmerchant_idis set to "reconDemo"
How to customize:
Change "
merchant_id" to match your own merchant code.Update "
txn_status" if needed.
2. Local Configuration
This configuration section defines how to process different types of transactions such as ORDER , REFUND , CHARGEBACK , DISPUTE, etc based on specific filter conditions.
2.1 Filters:
Each block starts with a filter condition that determines which rows the configuration applies to.
Configuration for
ORDERTransactions:
This configuration applies to rows where transaction_type equals "ORDER".
Configuration for
REFUNDTransactions:
This configuration applies to all rows that are NOT "ORDER" essentially REFUND or others.
2.2 Mappings:
Each configuration maps CSV column names to corresponding internal database field names.
Eg:
card_network:payment_methodsThis means the
card_networkcolumn in the CSV will be saved into thepayment_methodscolumn in the database.
3. Validation
The validation section defines a set of rules that your uploaded transaction data must pass before it's accepted for processing Ensuring Data Integrity. These checks help ensure that the data is clean, complete, and correctly formatted.
When a file is uploaded, the system will automatically run the defined validations on the mapped columns from your transaction file.
Validation Logic Breakdown
|
Validation Type
|
Purpose
|
|---|---|
date_format_check
| Validates date string format
|
duplicate_records_check
| Ensures unique values for critical identifiers
|
nan_value_check
| Ensures required fields are not empty or null
|
numeric_dtype_check
| Confirms numeric fields contain valid numbers
|
pkey_check
| Verifies uniqueness and presence for primary key field
|
scientific_value_check
| Rejects exponential notation for consistency
|
💡 To enable any validation, make sure the corresponding name is added to the checks list at the end of the validation block.
- Have questions?
- Need help? Contact support
- LLM? Read llms.txt

