Skip to main content

Submit Dispute Evidence to Bank

Suggest Edits

Overview​

Manually submit all uploaded evidence to the issuing bank to move the dispute forward. This endpoint packages all evidence files and sends them to the card network for review. Once submitted, the bank will review the evidence and make a determination on the dispute.

Resource Access​

Production (api.ahrvo.network)

POST https://api.ahrvo.network/payments/na/disputes/\{dispute_id}/submit

Staging (gateway.ahrvo.network)

POST http://gateway.ahrvo.network/payments/na/disputes/\{dispute_id}/submit

Arguments​

AttributeMandatory / OptionalDescription
dispute_idMandatoryThe unique ID of the dispute
Finix-VersionMandatorySpecify the API version (e.g., 2022-02-01)
noteOptionalA note to attach to the submission for internal tracking

Example Request​

curl -X POST https://gateway.ahrvo.network/payments/na/disputes/DPxxxxxxxxxxxxxxxxxx/submit \
  -H "Content-Type: application/json" \
  -H "Authorization: Basic <base64_encoded_credentials>" \
  -H "Finix-Version: 2022-02-01" \
  -d '{
    "note": "Submitting Dispute Evidence: Complete transaction documentation including receipt and shipping confirmation"
  }'

Example Response​

{
  "id": "DPxxxxxxxxxxxxxxxxxx",
  "created_at": "2025-12-08T14:30:00Z",
  "updated_at": "2025-12-10T13:20:00Z",
  "amount": 50000,
  "transfer": "TRxxxxxxxxxxxxxxxxxx",
  "reason": "FRAUD",
  "respond_by": "2025-12-22T23:59:59Z",
  "state": "PENDING",
  "response_state": "RESPONDED",
  "evidence_submitted": "CHARGEBACK",
  "tags": {
    "order_id": "ORDER-12345"
  },
  "_links": {
    "self": {
      "href": "https://api.ahrvo.network/payments/na/disputes/DPxxxxxxxxxxxxxxxxxx"
    },
    "transfer": {
      "href": "https://api.ahrvo.network/payments/na/transfers/TRxxxxxxxxxxxxxxxxxx"
    },
    "evidence": {
      "href": "https://api.ahrvo.network/payments/na/disputes/DPxxxxxxxxxxxxxxxxxx/evidence"
    }
  }
}

Important Notes​

  • Ensure all relevant evidence files are uploaded before submitting
  • Once submitted, the response_state will change to RESPONDED
  • You cannot upload additional evidence after submission
  • The bank typically takes 30-90 days to review and make a determination
  • Make sure to submit before the respond_by deadline

API Documentation​