JUSPAY Unified Dashboard

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.

Batch ALT ID Generation
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.

Batch ALT ID Generation
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

    Batch ALT ID Generation - Table View
    Batch ALT ID Generation - Table View

    1. 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

    Batch ALT ID Generation - Detailed View
    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

Scroll inside to view more
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:

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)

Last updated 2 months ago