Docs: updating mentions of Littlepay with transit processor in product docs #3021

indexing · 2025-07-17T22:05:48Z

Updating product documentation to reflect our support for Switchio as a payment processor via the Enghouse integration.

github-actions · 2025-07-17T22:06:35Z

Preview url: https://benefits-3021--cal-itp-previews.netlify.app

github-actions · 2025-07-17T22:07:07Z

Coverage report

This PR does not seem to contain any modification to coverable code.

machikoyasuda · 2025-07-17T22:22:59Z

docs/README.md

- Users need to [provide their credit or debit card information to our transit processor (Littlepay)](https://benefits.calitp.org/help#littlepay) to enroll in a discount.
+- To enroll for reduced fares as an older adult, U.S. Veteran, or Calfresh cardholder, riders need to [provide personal information to Login.gov](https://benefits.calitp.org/help#login-gov-verify).
+- To enroll for reduced fares as a Medicare cardholder, riders need to [provide personal information to Medicare.gov](https://www.medicare.gov/basics/get-started-with-medicare).
+- Eligible riders need to provide their contactless credit or debit card information to one of our transit processors, [Littlepay](https://benefits.calitp.org/help#littlepay) or [Switchio](https://benefits.calitp.org/help#littlepay), to register their card for reduced fares.


The links are fine for now. Switchio link to be updated in #2909

Now that #2909 is deployed:

Suggested change

- Eligible riders need to provide their contactless credit or debit card information to one of our transit processors, [Littlepay](https://benefits.calitp.org/help#littlepay) or [Switchio](https://benefits.calitp.org/help#littlepay), to register their card for reduced fares.

- Eligible riders need to provide their contactless credit or debit card information to one of our transit processors, [Littlepay or Switchio](https://benefits.calitp.org/help#payment_partners), to register their card for reduced fares.

Links directly to https://test-benefits.calitp.org/help#payment_partners

machikoyasuda · 2025-07-17T22:34:44Z

docs/README.md

 [i18n and l10n features][i18n].

-The application communicates with external services like [Littlepay][littlepay] via API calls and others like the [Identity Gateway](https://dev.auth.cdt.ca.gov) via redirects, both over the public internet. See [all the system interconnections][interconnections].
+The application communicates with external vendor services like [Littlepay][littlepay] and [Switchio](https://switchio.com/transport/) via API calls and others like the [Identity Gateway](https://dev.auth.cdt.ca.gov) via redirects, both over the public internet. See [all the system interconnections][interconnections].


Maybe we can replace the link on Identity Gateway to the CDT's page about it: https://digitalidstrategy.cdt.ca.gov/primary-elements.html

Updated CDT link to this URL.

Looks like you updated the wrong link, Andy. You updated the one in the paragraph below, not this paragraph Machiko commented on.

…switchio

… use case)

jgravois · 2025-10-02T17:29:55Z

docs/README.md

- Users need to [provide their credit or debit card information to our transit processor (Littlepay)](https://benefits.calitp.org/help#littlepay) to enroll in a discount.
+- To enroll for reduced fares as an older adult, U.S. Veteran, or Calfresh cardholder, riders need to [provide personal information to Login.gov](https://benefits.calitp.org/help#login-gov-verify).
+- To enroll for reduced fares as a Medicare cardholder, riders need to [provide personal information to Medicare.gov](https://www.medicare.gov/basics/get-started-with-medicare).
+- Eligible riders need to provide their contactless credit or debit card information to one of our transit processors, [Littlepay](https://benefits.calitp.org/help#littlepay) or [Switchio](https://benefits.calitp.org/help#littlepay), to register their card for reduced fares.


Suggested change

- Eligible riders need to provide their contactless credit or debit card information to one of our transit processors, [Littlepay](https://benefits.calitp.org/help#littlepay) or [Switchio](https://benefits.calitp.org/help#littlepay), to register their card for reduced fares.

- Eligible riders need to provide their contactless credit or debit card information to one of our transit processors, [Littlepay](https://benefits.calitp.org/help#littlepay) or [Switchio](https://benefits.calitp.org/help#switchio), to register their card for reduced fares.

i think creating a generic https://benefits.calitp.org/help#transit_processors page would be a great future-proof option too. (whether its in the glossary in the app or just in the docs)

a generic https://benefits.calitp.org/help#transit_processors page

derp. this has already been done! https://benefits.calitp.org/help#payment_partners

#3021 (comment)

cmajel · 2025-10-02T17:50:24Z

Recapping todos from the 10/2 chat

Validate if this hits all Littlepay references in current docs
Consider when to move away from specific names to more generic language for future growth (e.g. "transit processors")
Consider if we should add a plain language description of transit processors, and where that should live

@indexing please adjust if items are missing. If this feels right, I can take a pass at this.

- Removed references to specific vendors in the use case copy and replaced them with the more generic term <transit processor.> - Added a note in the Mermaid diagram to denote the two vendors providers use for fare processing.

- Revised and expanded overview copy - Revised Mermaid chart for System architecture - Revised Mermaid chart for Process - NOTE: We don't need to introduce Switchio here. All agencies using the agency card option are Littlepay and we don't intend to offer this option to new agencies onboarding to Cal-ITP Benefits.

…anguage for video demos

cmajel · 2025-10-08T15:27:41Z

@indexing I took a pass at this, changes include:

Adding a transit processors section within the Getting Started page where we can add additional processors as they grow
Removing Littlepay/Switchio references from the enrollment pathway mermaid charts for a more general "transit processor" label
Updating language before video demos to be a similar structure, which calls out Littlepay as what's demoed but notes its one of many transit processors

Scotchester

A few minor bits I noticed on lines below.

A more general comment: I appreciate the intent of all the "transit processor" and "transit provider" changes, however I think it risks creating confusion when they are used in close proximity to each other, due to the common transit pro.

I know we don't want to call the processors "payment processors", but could we consider sticking with "transit operator" instead of "transit provider", or is there an important distinction there, as well?

docs/README.md

docs/enrollment-pathways/agency-cards.md

docs/README.md

Co-authored-by: Scott Cranfill <[email protected]>

Soooo many typos. Thanks. Co-authored-by: Scott Cranfill <[email protected]>

Co-authored-by: Scott Cranfill <[email protected]>

Scotchester

Updated the previous suggestion on the reference link to add the subpage as suggested, and adding a new suggestion here to use it in the page above.

docs/README.md

Co-authored-by: Scott Cranfill <[email protected]>

indexing

👍

github-actions bot added the documentation [auto] Improvements or additions to documentation label Jul 17, 2025

indexing linked an issue Jul 17, 2025 that may be closed by this pull request

Switchio integration: documentation #2921

Open

machikoyasuda reviewed Jul 17, 2025

View reviewed changes

indexing changed the title ~~docs: updating mentions of littlepay or transit processor in product docs~~ Docs: updating mentions of Littlepay with transit processor in product docs Jul 22, 2025

thekaveman mentioned this pull request Sep 23, 2025

Switchio integration: documentation #2921

Open

indexing added 4 commits October 2, 2025 11:24

docs: udpating mentions of littlepay or transit processor to include …

e6783bb

…switchio

docs: updated URL for CDT

8b02197

docs: replacing Littlepay with transit processor (low-income use case)

bd1c94c

docs: replacing Littlepay with transit processor (Medicare cardholder…

15395c9

… use case)

indexing force-pushed the Enghouse-integration--updates-to-product-documentation-to-reflect-support-for-multiple-transit-processors branch from c6a8198 to 15395c9 Compare October 2, 2025 17:24

jgravois reviewed Oct 2, 2025

View reviewed changes

indexing and others added 5 commits October 3, 2025 15:33

docs: revisions to low-income use case

5e860ed

- Removed references to specific vendors in the use case copy and replaced them with the more generic term <transit processor.> - Added a note in the Mermaid diagram to denote the two vendors providers use for fare processing.

chore(pre-commit): autofix run

d8207ec

updating mermaid charts, adding transit processor section, parallel l…

d9d02f1

…anguage for video demos

chore(pre-commit): autofix run

43344b8

Scotchester reviewed Oct 8, 2025

View reviewed changes

cmajel and others added 6 commits October 9, 2025 10:14

Update docs/enrollment-pathways/agency-cards.md

cc895ca

Co-authored-by: Scott Cranfill <[email protected]>

Apply suggestion from @Scotchester

ec3d1c4

Soooo many typos. Thanks. Co-authored-by: Scott Cranfill <[email protected]>

Apply suggestion from @Scotchester

df1f02a

Co-authored-by: Scott Cranfill <[email protected]>

Apply suggestion from @Scotchester

1e616ed

Co-authored-by: Scott Cranfill <[email protected]>

Apply suggestion from @Scotchester

4dfeac0

Co-authored-by: Scott Cranfill <[email protected]>

Apply suggestion from @Scotchester

d47490f

Co-authored-by: Scott Cranfill <[email protected]>

Scotchester reviewed Oct 9, 2025

View reviewed changes

docs/README.md Outdated Show resolved Hide resolved

docs: application of Switchio reference link

7718009

Co-authored-by: Scott Cranfill <[email protected]>

Update Switchio link to https://switchio.com/transport/

c458e63

indexing commented Oct 9, 2025

View reviewed changes

	- Eligible riders need to provide their contactless credit or debit card information to one of our transit processors, [Littlepay](https://benefits.calitp.org/help#littlepay) or [Switchio](https://benefits.calitp.org/help#littlepay), to register their card for reduced fares.
	- Eligible riders need to provide their contactless credit or debit card information to one of our transit processors, [Littlepay or Switchio](https://benefits.calitp.org/help#payment_partners), to register their card for reduced fares.

Docs: updating mentions of Littlepay with transit processor in product docs #3021

Are you sure you want to change the base?

Docs: updating mentions of Littlepay with transit processor in product docs #3021

Uh oh!

Conversation

indexing commented Jul 17, 2025

Uh oh!

github-actions bot commented Jul 17, 2025

Uh oh!

github-actions bot commented Jul 17, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Coverage report

Uh oh!

machikoyasuda Jul 17, 2025

Choose a reason for hiding this comment

Uh oh!

machikoyasuda Aug 28, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

machikoyasuda Jul 17, 2025

Choose a reason for hiding this comment

Uh oh!

indexing Jul 18, 2025

Choose a reason for hiding this comment

Uh oh!

Scotchester Oct 2, 2025

Choose a reason for hiding this comment

Uh oh!

jgravois Oct 2, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

jgravois Oct 8, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cmajel commented Oct 2, 2025

Uh oh!

cmajel commented Oct 8, 2025

Uh oh!

Scotchester left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Scotchester left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

indexing left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

github-actions bot commented Jul 17, 2025 •

edited

Loading

machikoyasuda Aug 28, 2025 •

edited

Loading

jgravois Oct 2, 2025 •

edited

Loading

jgravois Oct 8, 2025 •

edited

Loading