Skip to content

feat: complete Veryfi PHP SDK API parity - #22

Merged
amaldona merged 5 commits into
mainfrom
cursor/api-coverage-audit-2bc9
Aug 21, 2026
Merged

amaldona merged 5 commits into
mainfrom
cursor/api-coverage-audit-2bc9

Conversation

@alejouribesanchez

@alejouribesanchez alejouribesanchez commented Aug 21, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

Implements every operation that the official Veryfi API documentation currently exposes and updates the audit to 100% coverage.

  • 151 documented operations revalidated from their live docs pages
  • 103 formerly missing operations added
  • 24 partial operations completed
  • 151 IMPLEMENTED / 0 PARTIAL / 0 MISSING / 0 UNCERTAIN
  • Existing public APIs remain source-compatible

Implementation

Correctness fixes

  • Encode GET parameters on the query string (RFC 3986) instead of JSON request bodies
  • Correct multipart handling and allow cURL to set multipart boundaries
  • Fix local-file uploads for W-2 and W-9
  • Preserve the AnyDocs $template_name argument while sending documented blueprint_name
  • Expand line-item request models for detailed-field objects and current fields

Added resource coverage

  • Existing resources: update, tags, async, bulk documents, tax lines, remittance checks, W-2/bank statement sets
  • Contracts
  • Parse/Markdown and document sets
  • Classify-and-extract
  • Fraud device blocklist
  • Settings: webhooks, client keys, v1 API keys, TLS certificates
  • Blueprints, OCR counts, OpenAPI schema, release notifications

All methods reuse veryfi\Client, the existing trait architecture, cURL request layer, authentication/signature logic, raw JSON string responses, and snake_case naming.

Documentation

  • docs/api-coverage-analysis.md: complete 151-row mapping and 100% metrics
  • README.md: pagination, async, Contracts, Markdown, tags/updates, and settings examples
  • PHPDoc URLs on every new operation

Validation

  • ./vendor/bin/phpunit --no-coverage: 179 tests, 676 assertions, passing
  • API parity suite: one contract test for every one of the 103 new operations
  • Parameter regressions: GET query encoding, AnyDocs blueprint, multipart W-2/W-9/classify/split, line-item schema
  • PHP syntax: 100 source/test files valid
  • Coverage report invariant: 151/151 IMPLEMENTED
  • composer.json JSON and PSR-4 mapping validated
  • git diff --check: passing

The Cloud image does not include the composer executable, so composer validate --strict could not be run locally; CI retains that validation step.

Open in Web Open in Cursor 

cursoragent and others added 5 commits August 21, 2026 15:51
Compare the PHP SDK public Client methods against every current
docs.veryfi.com API operation. Analysis only; no SDK source changes.

Co-authored-by: alejandro <alejandro@veryfi.com>
Co-authored-by: alejandro <alejandro@veryfi.com>
Co-authored-by: alejandro <alejandro@veryfi.com>
Co-authored-by: alejandro <alejandro@veryfi.com>
Co-authored-by: alejandro <alejandro@veryfi.com>
@cursor cursor Bot changed the title docs: Veryfi API coverage analysis for PHP SDK feat: complete Veryfi PHP SDK API parity Aug 21, 2026
@alejouribesanchez
alejouribesanchez marked this pull request as ready for review August 21, 2026 16:15
@amaldona
amaldona merged commit b6fe741 into main Aug 21, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants