Skip to main content

Fetch a Fee

Suggest Edits

Overview​

Retrieve the details of a specific fee by its unique identifier. This endpoint returns comprehensive information about the fee including amount, type, linked resources, and metadata.

Resource Access​

Production (api.ahrvo.network)

GET https://api.ahrvo.network/payments/na/fees/\{fee_id}

Staging (gateway.ahrvo.network)

GET http://gateway.ahrvo.network/payments/na/fees/\{fee_id}

Arguments​

AttributeMandatory / OptionalDescription
Finix-VersionMandatorySpecify the API version (e.g., 2022-02-01)
fee_idMandatoryThe unique ID of the fee to retrieve

Example Request​

curl -X GET https://gateway.ahrvo.network/payments/na/fees/FExxxxxxxxxxxxxxxxxx \
  -H "Content-Type: application/json" \
  -H "Authorization: Basic <base64_encoded_credentials>" \
  -H "Finix-Version: 2022-02-01"

Example Response​

Transaction-Generated Fee:

{
  "id": "FExxxxxxxxxxxxxxxxxx",
  "created_at": "2025-12-10T10:30:00Z",
  "updated_at": "2025-12-10T10:30:00Z",
  "amount": 275,
  "currency": "USD",
  "category": "PROCESSOR",
  "display_name": "Card Processing Fee",
  "fee_subtype": "PLATFORM_FEE",
  "fee_type": "CARD_BASIS_POINTS",
  "label": "card_processing",
  "linked_to": "TRxxxxxxxxxxxxxxxxxx",
  "linked_type": "TRANSFER",
  "merchant": "MRxxxxxxxxxxxxxxxxxx",
  "tags": {
    "transaction_date": "2025-12-10"
  },
  "_links": {
    "self": {
      "href": "https://api.ahrvo.network/payments/na/fees/FExxxxxxxxxxxxxxxxxx"
    },
    "transfer": {
      "href": "https://api.ahrvo.network/payments/na/transfers/TRxxxxxxxxxxxxxxxxxx"
    },
    "merchant": {
      "href": "https://api.ahrvo.network/payments/na/merchants/MRxxxxxxxxxxxxxxxxxx"
    }
  }
}

Custom Fee:

{
  "id": "FEyyyyyyyyyyyyyyyyyy",
  "created_at": "2025-12-10T16:00:00Z",
  "updated_at": "2025-12-10T16:00:00Z",
  "amount": 2500,
  "currency": "USD",
  "category": "PROCESSOR",
  "display_name": "December_Monthly_Service_Fee",
  "fee_subtype": "CUSTOM",
  "fee_type": "CUSTOM",
  "label": null,
  "linked_to": null,
  "linked_type": null,
  "merchant": "MRxxxxxxxxxxxxxxxxxx",
  "tags": {
    "billing_period": "2025-12",
    "category": "monthly_service_fee"
  },
  "_links": {
    "self": {
      "href": "https://api.ahrvo.network/payments/na/fees/FEyyyyyyyyyyyyyyyyyy"
    },
    "merchant": {
      "href": "https://api.ahrvo.network/payments/na/merchants/MRxxxxxxxxxxxxxxxxxx"
    }
  }
}

Understanding Fee Details​

Key Fields​

  • amount: Fee amount in cents
  • fee_type: General fee classification (CARD_BASIS_POINTS, CARD_FIXED, ACH_BASIS_POINTS, ACH_FIXED, CUSTOM)
  • fee_subtype: Specific fee category (PLATFORM_FEE, INTERCHANGE_FEE, CUSTOM)
  • linked_to: ID of the transfer or authorization that generated this fee (null for custom fees)
  • linked_type: Type of linked resource (TRANSFER, AUTHORIZATION, or null)
  • display_name: User-friendly description of the fee
  • label: Internal system label for the fee

Fee Categories​

  • category: Always PROCESSOR for processing-related fees

API Documentation​