Skip to main content

List Dispute Adjustment Transfers

Suggest Edits

Overview​

List the adjustment transfers for a dispute. These transfers reflect the financial impact of the dispute on your account, showing debits when funds are held or returned to the cardholder, and credits when disputes are won.

Resource Access​

Production (api.ahrvo.network)

GET https://api.ahrvo.network/payments/na/disputes/\{dispute_id}/adjustment_transfers

Staging (gateway.ahrvo.network)

GET http://gateway.ahrvo.network/payments/na/disputes/\{dispute_id}/adjustment_transfers

Arguments​

AttributeMandatory / OptionalDescription
dispute_idMandatoryThe unique ID of the dispute
limitOptionalThe number of items to return
after_cursorOptionalReturn every resource created after the cursor value

Example Request​

curl -X GET "https://gateway.ahrvo.network/payments/na/disputes/DPxxxxxxxxxxxxxxxxxx/adjustment_transfers?limit=10" \
  -H "Content-Type: application/json" \
  -H "Authorization: Basic <base64_encoded_credentials>"

Example Response​

{
  "_embedded": {
    "transfers": [
      {
        "id": "TRxxxxxxxxxxxxxxxxxx",
        "amount": 50000,
        "type": "DISPUTE",
        "subtype": "MERCHANT_DEBIT",
        "state": "SUCCEEDED",
        "currency": "USD",
        "created_at": "2025-12-08T14:35:00Z",
        "updated_at": "2025-12-08T14:35:00Z",
        "_links": {
          "self": {
            "href": "https://api.ahrvo.network/payments/na/transfers/TRxxxxxxxxxxxxxxxxxx"
          },
          "dispute": {
            "href": "https://api.ahrvo.network/payments/na/disputes/DPxxxxxxxxxxxxxxxxxx"
          }
        }
      },
      {
        "id": "TRyyyyyyyyyyyyyyyyyy",
        "amount": 1500,
        "type": "DISPUTE",
        "subtype": "PLATFORM_DEBIT",
        "state": "SUCCEEDED",
        "currency": "USD",
        "created_at": "2025-12-08T14:36:00Z",
        "updated_at": "2025-12-08T14:36:00Z",
        "_links": {
          "self": {
            "href": "https://api.ahrvo.network/payments/na/transfers/TRyyyyyyyyyyyyyyyyyy"
          },
          "dispute": {
            "href": "https://api.ahrvo.network/payments/na/disputes/DPxxxxxxxxxxxxxxxxxx"
          }
        }
      }
    ]
  },
  "page": {
    "offset": 0,
    "limit": 10,
    "count": 2
  },
  "_links": {
    "self": {
      "href": "https://api.ahrvo.network/payments/na/disputes/DPxxxxxxxxxxxxxxxxxx/adjustment_transfers?limit=10"
    }
  }
}

Understanding Adjustment Transfer Subtypes​

Dispute adjustment transfers can have the following subtypes:

Debit Transfers (Money Out)​

  • MERCHANT_DEBIT: Funds debited from the merchant account (dispute amount + fees)
  • PLATFORM_DEBIT: Chargeback fees debited from the platform

Credit Transfers (Money In)​

  • MERCHANT_CREDIT: Funds credited back to merchant (dispute won)
  • PLATFORM_CREDIT: Fees credited back to platform (dispute won)

Typical Dispute Flow​

  1. Dispute Created: Initial MERCHANT_DEBIT for disputed amount
  2. Chargeback Fee: PLATFORM_DEBIT for processing fee
  3. Dispute Won (if applicable): MERCHANT_CREDIT and PLATFORM_CREDIT reverse the debits
  4. Dispute Lost: No additional transfers, original debits remain

API Documentation​