Status Tracking, Retry, and Exception Handling

Your system should maintain a Click to Pay status record for each eligible card/payment instrument. This record is required for support, reconciliation, retry handling, and audit evidence.

Control Expected implementation
Status storage Store enrollment status per card/payment instrument, such as Pending, Enrolled, Failed, Deleted, Opted Out, or Excluded.
Request tracking Store the request reference, enrollment attempt date, final status, and error reason returned by the API.
Retry handling Retry transient failures using a controlled retry process. Do not endlessly retry validation, eligibility, or opt-out errors.
Error classification Classify errors as data issue, eligibility issue, API issue, duplicate/already enrolled, opt-out, or manual review.
Idempotency Design enrollment and lifecycle jobs so repeated processing does not create duplicate or conflicting actions.
Operational queue Provide a queue or report for pending, failed, and manually reviewed records.