Generate & regenerate evidence

Generating evidence is the core EaaS action: you hand Chargeflow a dispute - by dispute_id or inline - and it returns an AI-composed, versioned evidence package. This page covers the call, its error codes, and how to regenerate as new data arrives.

Generate evidence

Use the Generate Evidence API to kick off AI-powered evidence creation for a dispute.

POST /public/2025-04-01/evidence

The endpoint accepts either an existing Chargeflow dispute_id or a full inline dispute object. You do not need to create the dispute separately first.

Integration patterns

Option A, reference an existing dispute:

curl -X POST https://api.chargeflow.io/public/2025-04-01/evidence \
  -H "x-api-key: YOUR_PLATFORM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "66e6ea9ecd94925a9f8060d9",
    "dispute": {
      "dispute_id": "66e6ea9ecd94925a9f8060d9"
    }
  }'

Option B, submit dispute data inline:

curl -X POST https://api.chargeflow.io/public/2025-04-01/evidence \
  -H "x-api-key: YOUR_PLATFORM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "66e6ea9ecd94925a9f8060d9",
    "dispute": {
      "dispute_data": {
        "source_id": "du_123456789",
        "created_at": "2024-02-10T12:00:00Z",
        "reason": "fraud",
        "due_by": "2024-02-20T12:00:00Z",
        "amount": 150.00,
        "currency": "USD",
        "status": "needs_response",
        "transaction": {
          "source_id": "tx_1234567890",
          "created_at": "2024-02-08T10:00:00Z",
          "type": "paid",
          "amount": 150.00,
          "currency": "USD"
        }
      }
    }
  }'

Response

The API responds immediately with an in_progress status. Evidence generation is asynchronous; the PDF is not included in the response. Listen for the evidence.ready or evidence.error webhooks to know when it completes.

{
  "id": "ev_abc123456789",
  "account_id": "acct_9876543210",
  "ext_account_id": "ext_acct_54321",
  "dispute": "dp_1122334455",
  "created_at": "2025-07-29T14:35:00Z",
  "status": "in_progress",
  "file_url": null,
  "file_version": 1
}

Generation typically completes in ~30 seconds, with a maximum of ~3 minutes.

Error codes

Regenerate evidence

Evidence can be regenerated at any time while the dispute remains in needs_response status. Each regeneration attempt increments file_version, giving you a full history of evidence revisions.

curl -X POST https://api.chargeflow.io/public/2025-04-01/evidence \
  -H "x-api-key: YOUR_PLATFORM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "66e6ea9ecd94925a9f8060d9",
    "dispute": {
      "dispute_id": "66e6ea9ecd94925a9f8060d9"
    }
  }'

The response will show file_version: 2 (or higher) once the new PDF is ready.

When to regenerate:

• New order data has become available (tracking, fulfillment, etc.)
• The merchant has added communication logs or policy context
• You received an evidence.error and have resolved the underlying issue

Report dispute outcomes

When disputes are resolved (won or lost), share the outcome with Chargeflow. This data helps the AI continuously refine dispute strategies and improve win rates across all merchants on your platform.

Contact your account manager for the preferred method of submitting outcome data for your integration.

Next steps