Compliance & Screening

OFAC sanctions screening and compliance tools for recipient verification.

Screen Recipient

POST /api/v1/compliance/screening

Screen a recipient against OFAC sanctions lists and other watchlists.

curl -X POST https://api.paystream.fi/api/v1/compliance/screening \
  -H "Authorization: Bearer psk_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "recipientId": "rec_abc123"
  }'

Response:

{
  "data": {
    "result": "pass",
    "screenedAt": "2026-02-25T12:00:00Z",
    "listsChecked": ["sdn", "consolidated"],
    "matchScore": 0
  }
}

Screening Results

Result	Description	Action
pass	No match found	Recipient cleared
review	Potential match	Requires manual review
fail	Confirmed match	Block all transactions

Get Screening History

GET /api/v1/compliance/screening/:recipientId

Returns all screening results for a recipient.

Automatic Screening

Recipients are automatically screened during creation. If the identity field is provided on POST /api/v1/recipients, OFAC screening runs immediately.

Periodic re-screening can be triggered via the queue endpoint:

POST /api/v1/compliance/screening/queue

Tax Reporting

Get Tax Summary

GET /api/v1/reports/tax/:year/recipient/:recipientId

Get 1099 Forms

GET /api/v1/reports/1099/:year

Audit Log Export

POST /api/v1/admin/audit/export

Export the full audit log for compliance review.