Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Docs: supported agencies, enrollment pathways #1815

Merged
merged 11 commits into from
Dec 14, 2023
2 changes: 1 addition & 1 deletion docs/.pages
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
nav:
- Home:
- README.md
- use-cases
- enrollment-pathways
- getting-started
- product-and-design
- development
Expand Down
22 changes: 22 additions & 0 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,28 @@ The development of this publicly-accessible client is being managed by Caltrans'

The application is accessible to the public at [benefits.calitp.org](https://benefits.calitp.org).

### Adoption by transit agencies

The following California transit agencies have launched Cal-ITP Benefits for their riders, with the following enrollment pathway options:

| Transit agency | Older adults | Agency card | Veterans | Initial agency launch |
| ----------------------------------------------- | ------------ | ----------- | -------- | --------------------- |
| **Monterey-Salinas Transit** | Live | Live | Live | 05/2021 |
| **Santa Barbara Metropolitan Transit District** | Live | In test |   | 10/2023 |
| **Sacramento Regional Transit District** | In test |   |   |   |
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm wondering if we might want to track more than just the initial launch date, as in track the dates that a specific enrollment pathway was launched for a specific transit agency. So the table would be more like:
| Transit agency | Enrollment pathway | Launch date |

I think what you have here is a good start though, so I'll leave this as a thought that can be a future PR if we want

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yea we could but that's so granular, and it kinda really only affects MST - since most agencies don't offer a Veterans discount. We're trying to phase out Agency Cards, and perhaps in the future, more agencies can go live with multiple enrollment pathways so we don't have to be doing these incremental rollouts.


### Supported enrollment pathways

The Cal-ITP Benefits app supports the following enrollment pathways that use the corresponding eligibility verification methods:

| Enrollment pathway | Eligibility verification | Status | Launch |
| -------------------------------------------------------------- | ------------------------------------------------------------------------------------- | ------ | --------------------------------------------------------------------- |
| [**Older adults**](/benefits/enrollment-pathways/older-adults) | [Login.gov IAL2](https://developers.login.gov/attributes/) | Live | [8/2022](https://github.com/cal-itp/benefits/releases/tag/2022.08.1) |
machikoyasuda marked this conversation as resolved.
Show resolved Hide resolved
| [**Agency cards**](/benefits/enrollment-pathways/agency-cards) | [Eligibility API](https://docs.calitp.org/eligibility-api/specification/) | Live | [11/2022](https://github.com/cal-itp/benefits/releases/tag/2022.11.1) |
| [**Veterans**](/benefits/enrollment-pathways/veterans) | [Veteran Confirmation API](https://developer.va.gov/explore/api/veteran-confirmation) | Live | [9/2023](https://github.com/cal-itp/benefits/releases/tag/2023.09.1) |
machikoyasuda marked this conversation as resolved.
Show resolved Hide resolved

Read more about each [enrollment pathway](/benefits/enrollment-pathways/).

## Technical details

`benefits` is a [Django 4][django] web application. The application talks to one or more [Eligibility Verification APIs](https://docs.calitp.org/eligibility-api/specification) or authentication providers. These APIs and the application are
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,15 @@
title: Introduction
---

# Use cases
# Enrollment pathways

This section describes in more detail some of the use cases with current or planned support in the Benefits application.
This section describes in more detail some of the different enrollment pathways with current or planned support in the Benefits application.

## Current work

We do sprint planning and track day-to-day work on our [Project Board][board].

See our [Milestones][milestones] for current work tracked against specific features and use cases.
See our [Milestones][milestones] for current work tracked against specific features and different enrollment pathways.

## Product roadmap

Expand Down
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
# Seniors
# Older adults

One Benefits application use case is for riders age 65 years and older. The Benefits application verifies the person's age to confirm eligibility and allows those eligible to enroll their contactless payment card for their transit benefit.

Currently, the app uses [Login.gov's Identity Assurance Level 2 (IAL2)](https://developers.login.gov/attributes/) to confirm age, which requires a person to have a Social Security number, a valid state-issued ID card and a phone number with a phone plan associated with the person's name. Adding ways to confirm eligibility for people without a Social Security number, for people who are part of a transit agency benefit program are on the roadmap.

## Demonstration

Here's a GIF showing what the flow looks like, having seniors confirm eligibility via Login.gov and enroll via LittlePay:
Here's a GIF showing what the flow looks like, having older adults confirm eligibility via Login.gov and enroll via LittlePay:

![Demonstration of the sign-up process for a senior confirming eligibility via Login.gov and enrolling via Littlepay](img/senior-success.gif){ width="350" }

Expand Down
28 changes: 14 additions & 14 deletions docs/use-cases/Veterans.md → docs/enrollment-pathways/veterans.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Veterans enrollment pathway
# Veterans

## Overview

Expand Down Expand Up @@ -59,27 +59,27 @@ Littlepay-->>Benefits: payment method enrollment confirmation

## Alternative flows

* If the transit rider does not have a desktop computer, they can open the web application at [benefits.calitp.org](https://benefits.calitp.org) in a mobile browser on their iOS or Android tablet or mobile device to complete enrollment using the basic flow.
* Suppose the transit rider cannot authenticate with [Login.gov](https://Login.gov), or will not create an account. In either case, the app cannot determine their veteran status and, thus, cannot enroll their contactless debit or credit card for a reduced fare.
* If [VA.gov](http://VA.gov) determines the person does not meet the definition of a veteran (IdG returns a veteran status of FALSE), the Cal-ITP Benefits app will not allow the transit rider to enroll their contactless debit or credit card for a reduced fare.
* If the debit or credit card expires or is canceled by the issuer, the transit rider must repeat the basic flow to register a new debit or credit card.
* If the transit rider uses more than one debit or credit card to pay for transit, they repeat the basic flow for each card.
- If the transit rider does not have a desktop computer, they can open the web application at [benefits.calitp.org](https://benefits.calitp.org) in a mobile browser on their iOS or Android tablet or mobile device to complete enrollment using the basic flow.
- Suppose the transit rider cannot authenticate with [Login.gov](https://Login.gov), or will not create an account. In either case, the app cannot determine their veteran status and, thus, cannot enroll their contactless debit or credit card for a reduced fare.
- If [VA.gov](http://VA.gov) determines the person does not meet the definition of a veteran (IdG returns a veteran status of FALSE), the Cal-ITP Benefits app will not allow the transit rider to enroll their contactless debit or credit card for a reduced fare.
- If the debit or credit card expires or is canceled by the issuer, the transit rider must repeat the basic flow to register a new debit or credit card.
- If the transit rider uses more than one debit or credit card to pay for transit, they repeat the basic flow for each card.

## Postcondition

The transit rider receives a fare reduction each time they use the debit or credit card they registered to pay for transit rides. The number of times they can use the card to pay for transit is unlimited and the benefit never expires. 
The transit rider receives a fare reduction each time they use the debit or credit card they registered to pay for transit rides. The number of times they can use the card to pay for transit is unlimited and the benefit never expires.

## Benefits

* The transit rider no longer needs cash to pay for transit rides.
* The transit rider doesn’t have to lock up funds on a closed-loop card offered by the transit provider.
* The transit rider pays for transit rides with their debit or credit card, just as they pay for any other good or service that accepts contactless payment.
* The transit rider can enroll in a transit benefit from home when convenient; they do not have to visit a transit provider in person.
* Secure state and federal solutions manage the transit rider’s personal identifiable information (PII): [Login.gov](https://Login.gov) and the California Department of Technology Identity Gateway (IdG). Transit riders do not have to share personal information with local transit agencies.
* Benefits enrollment takes minutes rather than days or weeks.
- The transit rider no longer needs cash to pay for transit rides.
- The transit rider doesn’t have to lock up funds on a closed-loop card offered by the transit provider.
- The transit rider pays for transit rides with their debit or credit card, just as they pay for any other good or service that accepts contactless payment.
- The transit rider can enroll in a transit benefit from home when convenient; they do not have to visit a transit provider in person.
- Secure state and federal solutions manage the transit rider’s personal identifiable information (PII): [Login.gov](https://Login.gov) and the California Department of Technology Identity Gateway (IdG). Transit riders do not have to share personal information with local transit agencies.
- Benefits enrollment takes minutes rather than days or weeks.

## Example scenario

A veteran in California uses public transit regularly. They don’t have a car and depend on buses to get to appointments and do errands that take too long to use their bicycle. They receive a 50% fare reduction for being a US veteran but have to pay for transit rides using the closed loop card provided by the agency to receive the reduced fare. It’s frustrating and inconvenient to reload this agency card in $10 payments every week, especially because they sometimes need the money tied up on the card to pay for groceries and medication. 
A veteran in California uses public transit regularly. They don’t have a car and depend on buses to get to appointments and do errands that take too long to use their bicycle. They receive a 50% fare reduction for being a US veteran but have to pay for transit rides using the closed loop card provided by the agency to receive the reduced fare. It’s frustrating and inconvenient to reload this agency card in $10 payments every week, especially because they sometimes need the money tied up on the card to pay for groceries and medication.

The transit provider serving their part of California implements contactless payments on fixed bus routes throughout the service area. This rider uses [benefits.calitp.org](https://benefits.calitp.org) to confirm their veteran status and register their debit card for reduced fares. They tap to pay when boarding buses in their area and are automatically charged the reduced fare. They no longer need to carry one card to pay for transit and another for other purchases. Best of all, they have complete access to all funds in their weekly budget. If food and medication costs are higher one week, they can allocate additional funds to those areas and ride transit less.
34 changes: 0 additions & 34 deletions docs/use-cases/college.md

This file was deleted.

Loading