Inspiration
A buyer orders grade 316L steel, but the delivery certificate says 304. The paperwork has arrived; the agreed requirement has not been met.
We built ACCORD around this gap between receiving documents and deciding whether payment should proceed. Small manufacturers and suppliers need a visible reason to block payment, a clear correction path, and a record connecting the evidence to the financial action.
What it does
ACCORD checks delivery paperwork against approved requirements before a supplier captures a PayPal payment.
The buyer and supplier approve the same purchase order, lot, material grade and capture conditions. The buyer then approves a $750 PayPal Sandbox authorization. AI proposes findings with exact source passages; the backend checks their meaning and context against the agreed policy.
Delivered 304 fails a 316L requirement. Missing or conflicting evidence requires review. Uploading a corrected certificate alone does not unblock capture: the buyer must review and explicitly accept the replacement. A passing decision permits capture, while PayPal confirmation establishes the payment outcome separately.
The MVP supports one buyer, one supplier merchant and one final capture per deal, with capture initiation required within 48 hours of authorization. It checks documentary evidence; it does not establish that a certificate is truthful or that physical goods match it.
How we built it
We used Python and FastAPI for the backend, PostgreSQL for durable payment and evidence records, and HTML, CSS and JavaScript for the buyer/supplier interface. Gemini interprets supported PDF layouts and proposes cited findings. The model has no payment authority.
Separate extraction and payment workers keep document processing from blocking payment recovery. PayPal authorization, capture and verified webhooks connect the evidence decision to the payment state. Docker and GitHub Actions provide reproducible Linux acceptance checks.
Challenges we ran into
A correct quotation can still support the wrong interpretation. A certificate can contain both “required 316L” and “delivered 304,” so finding the desired number is insufficient. We bound findings to document versions, field meaning, purchase orders and lots, and kept ambiguous interpretations subject to review.
Payment uncertainty was equally important. A timeout can happen after capture succeeds. We preserved durable operations, request identities and payloads, guarded concurrent work, and displayed Reconciling until the outcome was established.
Accomplishments that we're proud of
- Demonstrated wrong evidence blocking capture and a reviewed replacement permitting it.
- Completed two real PayPal Sandbox captures with authenticated event verification, including a separate controlled response-loss test.
- Recovered that uncertain capture through provider reads with zero additional capture POSTs.
- Independently reproduced 95 PostgreSQL tests, passed Linux acceptance, and checked 10 recorded real Gemini cases against their PDFs, citations and admission rules.
Regression and Linux tests used explicit provider doubles; real PayPal and Gemini evidence was evaluated separately. The video clearly distinguishes the main deal from the archived recovery test.
What we learned
Useful AI needs an executable boundary around its conclusions. A citation, an interpretation and permission to move money are separate decisions.
We also learned that uncertainty needs a visible product state. Preserving a payment's identity and reconciling its outcome matters more than making a retry button appear responsive.
What's next for ACCORD
We want to test the workflow with manufacturers and suppliers, measure review time and error rates, and expand supported document layouts with adversarial fixtures. Production work would include stronger onboarding, monitoring and operational recovery procedures.
ACCORD is currently a validated Sandbox MVP. Customer adoption, dispute reduction and production readiness have not been established.
Built With
- css
- docker
- fastapi
- github-actions
- google-gemini
- html
- javascript
- paypal
- pdfplumber
- playwright
- postgresql
- pytest
- python
- render