Contrast Ratio Check

Ayesha Akhtar
Ayesha Akhtar
  • Updated

Feature Snapshot

Summary:
The Contrast Ratio Check is a TrustedForm Verify feature that programmatically measures the luminance difference between consent language text and its background to ensure it is clearly visible and meets regulatory as well as accessibility standards.

Key Benefits:

  • Ensures that consent language is rendered with sufficient contrast for legibility.
  • Mitigates risks of regulatory non-compliance and potential legal challenges.
  • Automates the verification process, reducing manual review and streamlining lead qualification.

Typical Use Cases:

  • Checking that lead generation forms display consent text with a minimum contrast ratio before processing leads.
  • Integrating contrast ratio evaluation into automated verification workflows within CRMs.
  • Filtering out leads where the consent language fails to meet the preset contrast threshold to protect business compliance.

How the Contrast Ratio Check works

When a lead is generated via a web form, TrustedForm Certify captures the entire consumer interaction by generating a certificate that documents visual elements—including the consent text. The Contrast Ratio Check measures the luminance difference between the text and its background against a predefined minimum threshold (e.g., 7:1 as recommended by Web Content Accessibility AAA Guidelines). This check is executed as part of the Verify API request, and the outcome is returned

Step‑by‑Step Instructions

  1. Implement TrustedForm Certify on your lead forms by having your vendors embed the TrustedForm Certify script to ensure each lead generates a certificate.
  2. Enable the Contrast Ratio Requirement in your TrustedForm account by navigating to the Verification Criteria page and entering your desired minimum ratio, then click “Save.”
  3. Make a Verify API Request using the Certificate API to run all enabled checks, including the Contrast Ratio Check.
  4. Review the API response: if the “success” property is true, all check have passed; if false, the “reason” field will explain if the contrast ratio check failed.

Expected Result:
The Verify API response will include a “success” property indicating true if the consent text meets the minimum contrast ratio and other configured requirements. Otherwise, it will return false with an accompanying “reason” detailing the failure.


Validation & Monitoring (optional)

  • Test the Setup: Submit a test lead and verify that the API response correctly reflects the contrast ratio requirement by checking the “success” property and associated reason messages.
  • Where to Monitor?: Monitor the results via your API integration logs.

Best Practices

  • Ensure that all lead vendors correctly implement TrustedForm Certify so that complete certificate data is captured.
  • Always set your minimum contrast ratio threshold to at least 3:1 to align with Web Content Accessibility Guidelines lowest standards.
  • Regularly review the “reason” messages in the Verify API responses to identify recurring contrast issues and address them with your vendors.
  • Integrate the outcome of the Contrast Ratio Check into your lead filtering processes using automated rules within your lead distribution software or CRM.

Troubleshooting

Symptom / Error Likely Cause Resolution
API response “success” property is false with a low contrast reason The displayed consent text has a contrast ratio below the required threshold Review your verification criteria settings; confirm that the contrast ratio requirement is correctly enabled and advise vendors to adjust styling if necessary.

Frequently Asked Questions (FAQ)

Q: What is Contrast Ratio Check?
A: It is a TrustedForm Verify feature that evaluates the luminance difference between consent text and its background to ensure the text is rendered with sufficient contrast for clarity and compliance.

Q: Why is Contrast Ratio Check important?
A: Adequate contrast is essential to guarantee that the consent language is clearly visible to consumers, thereby supporting regulatory compliance (such as TCPA) and meeting accessibility standards like WCAG AAA.

Q: How do I enable and use Contrast Ratio Check?
A: First, implement TrustedForm Certify on your web forms. Next, enable the Contrast Ratio Requirement in your TrustedForm account by setting a minimum ratio in the Verification Criteria. Finally, make a Verify API Request to automatically assess each certificate’s consent text against the threshold.

Q: What happens if a certificate fails the Contrast Ratio Check?
A: If the consent language does not meet the set contrast ratio, the Verify API response will return “success” as false, along with a “reason” detailing the issue, allowing you to flag or review the lead accordingly.


Glossary

Term Definition
Contrast Ratio A quantitative measure of the relative luminance between the foreground (consent text) and background.
TCPA Telephone Consumer Protection Act, which requires clear and conspicuous consumer consent.
WCAG Web Content Accessibility Guidelines that set standards for contrast to ensure content accessibility.
TrustedForm Certify A script provided by TrustedForm to generate a certificate that documents consumer interactions and consent.

Was this article helpful?

0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.