Search by

jeffersongoncalves / laravel-ccpa-vendors

jeffersongoncalves

CCPA/CPRA vendor register for Laravel: service providers, contractors and third parties, the contract terms of §1798.100(d) and Regulations §§7051-7053, reviews by risk and data return.

1.0.0 2026-11-17 16:34 UTC

This package is auto-updated.

Last update: 2026-11-17 16:34:56 UTC


README

Laravel CCPA Vendors

Latest Version on Packagist Tests Total Downloads

A register of the businesses you disclose personal information to, for the California Consumer Privacy Act, as amended by the CPRA. It is part of the laravel-ccpa suite.

Every service provider, contractor and third party you sell or share personal information with needs a written contract with specific terms (Cal. Civ. Code §1798.100(d); CCPA Regulations §§7051 and 7053). Without those terms, a "service provider" is treated as a third party, and the disclosure can count as a sale. For each vendor you record:

  • its role: service provider, contractor or third party (§1798.140(ag), (j) and (ai));
  • the business purpose the contract limits the use to;
  • a risk tier, which sets how often the vendor must be reviewed;
  • the contract: when it was signed and when it expires, plus a checklist of the terms its role requires;
  • when the relationship ended, and whether the data was deleted or returned.

Each vendor then tells you what it still owes.

This package gives you tooling. It does not make you compliant on its own. Your contracts need legal review.

Installation

composer require jeffersongoncalves/laravel-ccpa-vendors
php artisan vendor:publish --tag="ccpa-vendors-migrations"
php artisan migrate
php artisan vendor:publish --tag="ccpa-vendors-config"   # optional: contract terms, review intervals

Usage

use JeffersonGoncalves\CcpaVendors\Enums\{VendorRisk, VendorRole};
use JeffersonGoncalves\CcpaVendors\Models\Vendor;

$stripe = Vendor::create([
    'name' => 'Stripe',
    'role' => VendorRole::ServiceProvider,
    'services' => 'Card payments',
    'business_purpose' => 'Process payments for orders',
    'data_categories' => ['name', 'email', 'card data'],
    'risk' => VendorRisk::High,
    'dpa_signed_at' => '2026-01-10',
    'dpa_checklist' => ['no_sale_or_sharing' => true, 'specified_purpose' => true /* ... */],
]);

$stripe->issues();                 // [VendorIssue::AgreementIncomplete, ...]
$stripe->missingChecklistItems();  // ['no_combining', 'consumer_requests', ...]
$stripe->nextReviewAt();           // reviewed_at (or created_at) + review_every[risk]
$stripe->markReviewed();

$stripe->terminate();
$stripe->confirmDataReturned();

Contract terms by role

Role Terms
Service provider no selling or sharing, a specified business purpose, no other use or disclosure, no combining with other data, CCPA compliance and the same level of protection, your right to take reasonable steps, notice if it can no longer comply, your right to stop and remediate, subcontractors bound by the same terms, help with consumer requests (Regulations §7051(a))
Contractor the service provider terms, plus its certification that it understands and will comply (§1798.140(j))
Third party use limited to the purposes of the sale or sharing, CCPA compliance, your right to take reasonable steps, notice if it can no longer comply, your right to stop and remediate (Regulations §7053)

Change them in config/ccpa-vendors.php.

Issues

Issue When
agreement_missing no signed contract
agreement_expired dpa_expires_at has passed
agreement_incomplete the contract misses a term its role requires
review_due the last review is older than review_every for its risk tier (high: 1 year, medium: 2, low: 3)
data_return_pending the vendor was terminated and the data deletion or return is not confirmed

Report

php artisan ccpa:vendors             # every vendor, its next review and its issues
php artisan ccpa:vendors --issues    # only those with issues
php artisan ccpa:vendors --json

Testing

composer test

Changelog

See CHANGELOG.

License

The MIT License (MIT). See License File.