Visa Platforms Login
Enterprise Operations
- Batch Processing Design: Use batch operations for large-scale user management rather than individual API calls
- Asynchronous Processing: Migration and revalidation operations process asynchronously with status polling
- Error Recovery: Implement appropriate retry logic for batch operations using batch ID targeting
- Resource Management: Monitor processing resources for complex operations like duplicate cleanup
- Audit Trail Maintenance: Enterprise operations maintain detailed audit trails and compliance records
Data Migration
Migration and Data Transfer
Visa Platforms Login provides comprehensive migration capabilities for transferring existing user data into the GMAP system with detailed status tracking and error recovery mechanisms.
Bulk Migration Process
- Preparation: Prepare user registration requests with appropriate password algorithms and salt values
- Submission: Submit bulk migration using
POST /migratewith migration batch ID - Processing: System processes users and saves migration records to the migration repository
- Monitoring: Check progress using
GET /migrate/statuswith migrationBatchId or migrationId - Recovery: Retry failed migrations using
POST /migrate/{migrationBatchId}with optional status filter
Migration Management
- Batch Tracking:
GET /migrate/batchesretrieves migration batch IDs by migration ID and optional status filter - Status Monitoring: Migration system tracks status at the individual record level with detailed error reporting
- Selective Retry: Failed migrations can be retried by batch ID without reprocessing successful records
- Required Scope: MIGRATE_USERS OAuth2 scope required for all migration operations
Migration Data Requirements
- Password Algorithms: Support for multiple password algorithms with salt handling
- User Data: Complete user registration requests including site registration and concierge requests
- Force Update: forceRecordUpdate mechanism for overwriting existing records
- Batch Organization: Migration batch IDs organize related migration operations
Batch Operations
Batch Processing Operations
Batch processing capabilities enable efficient management of large-scale user operations with appropriate performance and error handling.
User Revalidation Batches
Process multiple users for OFAC screening, MOE synchronization, or program enrollment in batch operations.
- Individual Revalidation:
POST /user/re-validatefor single user with userDetailsId - Batch Revalidation:
POST /user/internal/batch/re-validatefor user ID ranges - Call Types: OFAC (sanctions screening), MOE (system sync), ENROLL_PROGRAM_AND_MOE (combined operations)
- Required Scope: SYSTEM_USER_RW for batch operations, RE_VALIDATE_USER for individual operations
Modified Users Tracking
Track user modifications within specified date ranges for audit and synchronization purposes.
- Endpoint:
GET /batch/modified-userswith date-time range parameters - Parameters: Start date-time, end date-time, and additional criteria parameter
- Usage: Identify users modified within specific time periods for downstream processing
System Administration
System Administration
Administrative operations provide system-level management capabilities for user accounts, duplicate cleanup, and internal system maintenance.
User Account Administration
- System Account Deletion:
POST /user/internal/system-remove-accountwith SYSTEM_REMOVE_USER scope - Site-Specific Removal:
POST /user/internal/remove-sitefor removing user from specific sites - Activation Email Management:
POST /user/internal/send-activation-emailwith SYSTEM_RESEND_ACTIVATION scope - Passwordless Registration:
POST /user/pwless-login-registrationfor internal client registrations
Duplicate Account Management
Clean up duplicate user accounts with intelligent merging that preserves unique data from both accounts.
- Cleanup Process:
POST /user/internal/clean-duplicate-accountswith two userDetailsIds - Merge Logic: Active or most up-to-date user is retained, other is deleted
- Data Transfer: Site data or assets existing only in deleted account are transferred to retained account
- Processing Time: Operations may take extended time for complex merges and data transfers
Advanced User Search
Enterprise search capabilities with advanced filtering, pagination, and sorting for large-scale user management.
- Cardholder Search:
POST /user/internal/cardholders-details/searchby last name or email - Search Criteria: Query, issuer filtering, input type, and user account status filtering
- Pagination: Configurable page size (max 500, min 1) with maximum 1000 pages
- Sorting: Configurable sort criteria with sortBy and sortOrder requirements
- Results: Include user statistics like days since last login and update timestamps
Reporting and Analytics
Reporting and Analytics
Generate comprehensive reports for enrollment tracking, concierge activity monitoring, and system health validation.
Enrollment Reporting
Generate cardholder enrollment reports for business intelligence and compliance monitoring.
- Endpoint:
GET /report/cardholder-enrollment - Parameters: siteId, from date, to date (all required with minLength 1)
- Response Format: Binary data stream (application/octet-stream) for file download
- Usage: Track enrollment patterns and program adoption by site and date range
Concierge Activity Reporting
Monitor concierge user activity and customer service operations.
- Endpoint:
GET /report/active-concierge - Parameters: from date, to date (both required with minLength 1)
- Response Format: Binary data stream for file download
- Scope Requirement: Appropriate reporting permissions
System Health Monitoring
Validate system connectivity and integration health.
- Connection Testing:
GET /connection/test-alltests all system connections - Response Format: Key-value pairs indicating connection status for each tested system
- Usage: Proactive monitoring of system integration health
DTS Integration
Data Token Service (DTS) Operations
DTS integration provides tokenization services for secure handling of sensitive user data with separate token lifecycle management.
DTS User Detail Management
- Save Operations:
POST /dts/savesaves DTS user details into user-mgmt database - Retrieval:
GET /dts/findfetches DTS user details by userDetailsId - Update Preparation:
GET /dts/find-for-updateretrieves details for update operations - Cleanup:
DELETE /dts/deleteremoves DTS user details when no longer needed
DTS Integration Requirements
- Scope Requirement: USER-ATTRIBUTES_RW OAuth2 scope for DTS operations
- User Association: DTS user details require specific userDetailsId association
- Token Management: DTS tokens are managed separately from main user authentication
- Versioning: DTS maintains separate versioning system alongside main user management