Account updater models
Account updater models manage automatic credit card updates from card issuers to maintain current payment information.CreditCardUpdaterStatus
Tracks the current status of credit cards in the account updater system.Key properties
| Property | Type | Description |
|---|---|---|
| Id | Guid | Unique identifier |
| CreditCardId | Guid | Associated credit card reference |
| Status | String | Current updater status |
| LastChecked | DateTime | Last update check timestamp |
| NextCheckDate | DateTime | Scheduled next check date |
| UpdatesReceived | Int | Total updates received |
Relationships
- Belongs to a CreditCard
- Has many CreditCardUpdaterHistory records
Status values
| Status | Description |
|---|---|
| Active | Card enrolled in updater service |
| Pending | Enrollment pending |
| Updated | Card information updated |
| Closed | Card account closed |
| Contact cardholder | Manual intervention required |
| Inactive | Not enrolled in updater service |
CreditCardUpdaterHistory
Maintains a historical record of all account updater changes for a credit card.Key properties
| Property | Type | Description |
|---|---|---|
| Id | Guid | Unique identifier |
| CreditCardId | Guid | Associated credit card reference |
| ChangeType | String | Type of change received |
| OldValue | String | Previous value (encrypted) |
| NewValue | String | Updated value (encrypted) |
| ReceivedDate | DateTime | Date update was received |
| AppliedDate | DateTime? | Date update was applied |
| ProcessorResponse | String | Processor response details |
Relationships
- Belongs to a CreditCard
Change types
- Expiration date - Card expiration updated
- Card number - Card number changed (reissue)
- Account closed - Card account closed
- Contact cardholder - Update requires customer contact
AccountUpdaterHistoryRecord
Aggregated history records for reporting and auditing account updater activity.Key properties
| Property | Type | Description |
|---|---|---|
| Id | Guid | Unique identifier |
| ProjectId | Guid | Associated project reference |
| BatchDate | DateTime | Updater batch processing date |
| TotalCards | Int | Total cards checked |
| UpdatesReceived | Int | Updates received in batch |
| CardsUpdated | Int | Cards successfully updated |
| ErrorCount | Int | Errors encountered |
Relationships
- Belongs to a Project
Usage patterns
Automatic updates
The account updater service automatically checks for card updates on a scheduled basis (typically monthly). When updates are received, they are applied to stored payment methods.Update notifications
When card information is updated:- Update is received from processor
- Change is logged in history
- Card record is updated
- Customer notification is sent (optional)
Handling closed accounts
When a card account is closed, the status is updated and recurring billing is paused until a new payment method is provided.Manual intervention
Some updates require manual customer contact. These are flagged for follow-up by customer service teams.Best practices
- Enable account updater for all stored payment methods
- Monitor update success rates
- Automate customer notifications for card updates
- Review “contact cardholder” cases promptly
- Maintain audit logs of all card updates
Security considerations
- All card data changes are encrypted
- Update history is maintained for compliance
- Access to updater data is restricted
- Changes are logged for audit purposes