--- page_title: Batch ALT ID Generation product: JUSPAY Unified Dashboard page_source: https://juspay.io/in/docs/dashboard/docs/payments/batch-alt-id-generation llms_txt: https://juspay.io/in/docs/llms.txt product_llms_txt: https://juspay.io/in/docs/dashboard/llms.txt --- # Batch ALT ID Generation ## Overview The Batch ALT ID Generation module provides comprehensive bulk ALT ID generation capabilities for processing multiple card ALT ID requests simultaneously through CSV file uploads. It offers real-time progress tracking, status monitoring, and detailed reporting for all ALT ID generation operations processed through the Juspay payment platform. This module is designed for a wide range of users, including: * **Technical Teams** : For generating ALT IDs in bulk for payment cards and monitoring ALT ID generation performance across different card types with comprehensive technical logs. * **Integration Teams** : For bulk ALT ID processing, system integration management, and tracking ALT ID generation status across multiple card records with detailed integration trails. * **Payment Processing Teams** : To generate ALT IDs for customer cards in bulk, track generation status, and provide ALT ID-based payment processing for enhanced card integration. ## Accessing the Module 1. **Log in** to the Juspay dashboard. 2. From the main navigation menu on the left, click on **Payments** . 3. Select **Bulk Operations** from the Payments submenu. 4. Click on the **ALT ID Generation** tab from the bulk operations navigation. 5. The navigation URL for this module is https://portal.juspay.in/batch/batch-altid-generation. ![Image](https://dth95m2xtyv8v.cloudfront.net/tesseract/assets/dashboard/Screenshot%202025-09-26%20at%2010.34.40%E2%80%AFPM.png) *Batch ALT ID Generation* ## Step-by-Step Usage Instructions ### Creating Batch ALT ID Generation #### Step 1: Access the Batch ALT ID Generation Interface 1. Navigate to the Batch ALT ID Generation module using the steps above. 2. You will see the main dashboard with a description: "This module helps in creating ALT ID generation in bulk using a file upload. It provides a holistic view of the files uploaded. Upon clicking the filename in the table below a detailed view of each ALT ID generation uploaded is displayed." 3. The interface displays any previously uploaded batch ALT ID generation files in a table format. #### Step 2: Initiate New Batch ALT ID Generation Upload 1. Click the **"Create Batch ALT ID Generation"** button (visible only to users with appropriate permissions). 2. If maker-checker workflow is enabled for your account, you will first see a description modal: * Enter a description for the batch ALT ID generation request in the text field. * Click **"Submit"** to proceed to the file upload interface. 3. If maker-checker is not enabled, you will directly access the file upload interface. ![Image](https://dth95m2xtyv8v.cloudfront.net/tesseract/assets/dashboard/Screenshot%202025-09-26%20at%2010.34.47%E2%80%AFPM.png) *Batch ALT ID Generation* #### Step 3: Prepare and Upload CSV File 1. **Download Sample File** : Click on the sample file link to download the CSV template (`batch_altid_provision_sample.csv`). 2. **Prepare Your Data** : Fill in your card data following the CSV field specifications (see table below). 3. **File Limitations** : * Maximum 1000 rows per file * CSV format only * File size limitations apply 4. **Upload Process** : * Click **"Choose File"** or drag and drop your CSV file * The system validates the file format and structure * Mandatory fields are checked (Card Number, Card Expiry Month, Card Expiry Year) * Column types are validated (Card Number as String, Expiry Month/Year as String) #### Step 4: File Processing and Validation 1. **File Validation** : The system performs the following checks: * CSV format validation * Mandatory field presence (cardNumber, cardExpiryMonth, cardExpiryYear) * Data type validation for each column * Card number length validation (15 or 16 digits) * Expiry date validation * Row count validation (maximum 1000 rows) 2. **Error Handling** : If validation fails, specific error messages are displayed: * Missing mandatory fields * Invalid card number length (must be 15 or 16 digits) * Invalid expiry date format * File format errors * Row limit exceeded 3. **Successful Upload** : Upon successful validation: * File is queued for processing * Batch ID is generated * Initial status is set to processing * ALT ID generation process begins #### Step 5: Monitor Processing Status 1. **Status Indicators** : * **ACCEPTED** : Successfully generated ALT IDs (Green indicator) * **FAILED** : Failed ALT ID generation attempts (Red indicator) * **QUEUED** : ALT ID requests waiting in processing queue (Blue indicator) ### Monitoring and Managing Batch ALT ID Generation #### Viewing Batch ALT ID Generation Details 1. **Table View** : The main interface displays all uploaded batch files with: * File Name: Name of the uploaded CSV file * File Upload Status: Current processing status with color-coded labels * Total Cards: Number of ALT ID generation requests in the file * Date Created: File upload timestamp * Last Modified: Last update timestamp * Total Tasks: Number of ALT ID generation requests in the file * Tasks Progress: Visual progress bar showing completion status * Actions: Sync with Gateway button for manual synchronization ![Image](https://dth95m2xtyv8v.cloudfront.net/tesseract/assets/dashboard/Screenshot%202025-09-26%20at%2010.35.06%E2%80%AFPM.png) *Batch ALT ID Generation - Table View* 2. **Detailed View** : Click on any filename to access detailed information: * **Batch Details Card** : Expandable/collapsible interface showing: * Batch ID: Unique identifier for the uploaded file * Date Created and Date Updated timestamps * Total Cards with count formatting * Current status with color-coded indicators * **Progress Statistics** : Individual task counts for: * Total Accepted Tasks: Successfully generated ALT IDs * Total Rejected Tasks: Failed ALT ID generation attempts * Total Queued Tasks: ALT IDs in processing queue ![Image](https://dth95m2xtyv8v.cloudfront.net/tesseract/assets/dashboard/Screenshot%202025-09-26%20at%2010.35.41%E2%80%AFPM.png) *Batch ALT ID Generation - Detailed View* #### Search and Filter Capabilities 1. **File Name Search** : * Use the search input field with search icon * Enter filename to filter results * Search is case-sensitive and supports partial matches * Clear search using the cross icon 2. **Table Sorting** : * Click column headers to sort data * Available sorting for: File Name, Status, Total Cards, Date Created, Total Tasks * Toggle between ascending and descending order ### Data Export and Download #### Downloading Processed Data 1. **Access Download** : Click the **"Download Data"** button in the batch details view. 2. **CSV Export** : Downloads include: * Serial numbers (S.No column) * All processed ALT ID generation data with the following headers: * Card Number (masked for security) * Card Expiry Month * Card Expiry Year * ALT ID * Generation Status * Associate ID * Udf1 through Udf10 (User Defined Fields) * Task Status * Error Message * Created At * Updated At 3. **File Format** : * CSV format with comma-separated values * Filename format: `batch_altid_generation.csv` * Includes header row with column names * **Important** : ALT IDs are only available for 24 hours after generation ## CSV File Upload Specifications ### CSV Field Requirements | Field Name | Mandatory/Optional | Data Type | Description | Sample Value | Validation Rules | |---|---|---|---|---|---| | cardNumber | Mandatory | String | Payment card number for ALT ID generation | "4111111111111111" | Must be 15 or 16 digits, numeric characters only | | cardExpiryMonth | Mandatory | String | Card expiry month (MM format) | "12" | Must be valid month (01-12) | | cardExpiryYear | Mandatory | String | Card expiry year (YYYY format) | "2025" | Must be valid future year (YYYY format) | | associateId | Optional | String | Associate identifier for tracking | "ASSOC_123456" | String value, can be empty | | udf1 | Optional | String | User Defined Field 1 | "CustomValue1" | String value, custom data field | | udf2 | Optional | String | User Defined Field 2 | "CustomValue2" | String value, custom data field | | udf3 | Optional | String | User Defined Field 3 | "CustomValue3" | String value, custom data field | | udf4 | Optional | String | User Defined Field 4 | "CustomValue4" | String value, custom data field | | udf5 | Optional | String | User Defined Field 5 | "CustomValue5" | String value, custom data field | | udf6 | Optional | String | User Defined Field 6 | "CustomValue6" | String value, custom data field | | udf7 | Optional | String | User Defined Field 7 | "CustomValue7" | String value, custom data field | | udf8 | Optional | String | User Defined Field 8 | "CustomValue8" | String value, custom data field | | udf9 | Optional | String | User Defined Field 9 | "CustomValue9" | String value, custom data field | | udf10 | Optional | String | User Defined Field 10 | "CustomValue10" | String value, custom data field | ### Card Validation Rules **Card Number Requirements** : * **Length** : Card number must be 15 or 16 digits * **Format** : Only numeric characters allowed * **All major card networks supported** : Visa, Mastercard, American Express, Maestro, etc. **Validation Process** : 1. **Length Validation** : Card number must be 15 or 16 digits 2. **Format Check** : Only numeric characters allowed 3. **Expiry Date Validation** : Month (01-12) and year (2-digit format) validation 4. **CVV Validation** : 3 or 4 digits (if provided) ### Expiry Date Format Requirements **Format Specification** : * **cardExpiryMonth** : MM format (01-12) * **cardExpiryYear** : YYYY format (four-digit year) * **Future Date** : Expiry date must be in the future * **Valid Examples** : Month: "01", "12"; Year: "2025", "2030" * **Invalid Examples** : Month: "1", "13"; Year: "25", "2020" ### CSV Format Examples **Complete CSV Format with Sample Data:** #### csv Code Snippet: ```csv cardNumber,cardExpiryMonth,cardExpiryYear,udf1,udf2,udf3,udf4,udf5,udf6,udf7,udf8,udf9,udf10,associateId 4111111111111111,12,2025,Custom_Value_1,Custom_Value_2,,,,,,,,,ASSOC_123456 5555555555554444,06,2027,Custom_Value_3,Custom_Value_4,,,,,,,,,ASSOC_789012 378282246310005,03,2026,Custom_Value_5,Custom_Value_6,,,,,,,,,ASSOC_345678 6011111111111117,09,2028,Custom_Value_7,Custom_Value_8,,,,,,,,,ASSOC_901234 ``` ### File Upload Constraints * **Maximum Rows** : 1000 rows per CSV file * **File Format** : CSV (Comma Separated Values) only * **Encoding** : UTF-8 encoding recommended * **File Size** : Standard file size limitations apply * **Column Order** : Must match the specified header format * **Empty Values** : Optional fields can be left empty but commas must be maintained * **Card Format** : Card numbers must be 15 or 16 digits, numeric characters only ## Use Cases ### Payment Gateway Integration Setup 1. Export payment card data from existing payment systems 2. Prepare CSV file with card numbers, expiry dates, and associate IDs 3. Upload file through Batch ALT ID Generation interface 4. Download generated ALT IDs within 24 hours for integration ### Bulk Payment Processing Preparation 1. Prepare CSV with payment card information for ALT ID generation 2. Include associate IDs for proper tracking and association 3. Upload file for automated ALT ID generation processing 4. Track individual generation status and download ALT ID results ### System Integration Management 1. Compile payment card data from various payment sources 2. Create CSV with card details and tracking references in UDF fields 3. Process bulk ALT ID generation and export results for system integration 4. Use downloaded ALT ID data for enhanced payment processing within 24-hour window ## Troubleshooting **File Upload Validation Errors:** * **"Invalid file format"** : Ensure file is in CSV format with proper comma separation * **"Missing mandatory fields"** : Verify that cardNumber, cardExpiryMonth, and cardExpiryYear columns are present and not empty * **"Row limit exceeded"** : Reduce file size to maximum 1000 rows per upload * **"Card number must be 15 or 16 digits"** : Ensure card numbers are exactly 15 or 16 digits long * **"Invalid expiry date format"** : Ensure expiry month is in MM format (01-12) and year is in YYYY format ## Permissions and Roles Access to the Batch ALT ID Generation module is controlled by the following permissions: * **ALT ID Generation Module Access** : Required for accessing the batch ALT ID generation interface (ACL: `batch_alt_id`) * **ALT ID Generation Write Permission** : Required for creating and uploading batch ALT ID generation files (ACL: `batch_alt_id` with ReadWrite access) * **ALT ID Generation Read Permission** : Needed to view batch ALT ID generation status and download processed data (ACL: `batch_alt_id`) --- ## See Also - [Batch Sync](https://juspay.io/in/docs/dashboard/docs/payments/batch-sync) - [Batch Mandate](https://juspay.io/in/docs/dashboard/docs/payments/batch-mandate)