Skip to main content

Fetch a Fee Profile

Suggest Edits

Overview​

Retrieve the details of a specific fee profile by its unique identifier. This endpoint returns the complete pricing configuration including all card, ACH, EFT, dispute, and ancillary fees.

Resource Access​

Production (api.ahrvo.network)

GET https://api.ahrvo.network/payments/na/fee_profiles/\{fee_profile_id}

Staging (gateway.ahrvo.network)

GET http://gateway.ahrvo.network/payments/na/fee_profiles/\{fee_profile_id}

Arguments​

AttributeMandatory / OptionalDescription
fee_profile_idMandatoryThe unique ID of the fee profile to retrieve

Example Request​

curl -X GET https://gateway.ahrvo.network/payments/na/fee_profiles/FPxxxxxxxxxxxxxxxxxx \
  -H "Content-Type: application/json" \
  -H "Authorization: Basic <base64_encoded_credentials>"

Example Response​

{
  "id": "FPxxxxxxxxxxxxxxxxxx",
  "created_at": "2025-12-01T10:00:00Z",
  "updated_at": "2025-12-05T14:30:00Z",
  "application": "APxxxxxxxxxxxxxxxxxx",
  "rounding_mode": "AGGREGATE",
  "basis_points": 275,
  "fixed_fee": 10,
  "charge_interchange": true,
  "card_cross_border_basis_points": 15,
  "card_cross_border_fixed_fee": 30,
  "ach_basis_points": 20,
  "ach_fixed_fee": 30,
  "ach_basis_points_fee_limit": 5000,
  "ach_credit_return_fixed_fee": 500,
  "ach_debit_return_fixed_fee": 500,
  "ach_notice_of_change_credit_fixed_fee": 100,
  "ach_notice_of_change_debit_fixed_fee": 100,
  "eft_basis_points": 25,
  "eft_fixed_fee": 35,
  "eft_basis_points_fee_limit": 5500,
  "eft_credit_return_fixed_fee": 550,
  "eft_debit_return_fixed_fee": 550,
  "dispute_fixed_fee": 1500,
  "dispute_inquiry_fixed_fee": 1000,
  "settlement_funding_transfer_ach_basis_points": 10,
  "settlement_funding_transfer_ach_fixed_fee": 25,
  "settlement_funding_transfer_ach_basis_points_fee_limit": 3000,
  "settlement_funding_transfer_eft_basis_points": 10,
  "settlement_funding_transfer_eft_fixed_fee": 25,
  "settlement_funding_transfer_eft_basis_points_fee_limit": 3000,
  "ancillary_fixed_fee_primary": 32,
  "ancillary_fixed_fee_secondary": 80,
  "american_express_basis_points": 300,
  "mastercard_basis_points": 275,
  "visa_basis_points": 275,
  "discover_basis_points": 275,
  "jcb_basis_points": 300,
  "diners_club_basis_points": 300,
  "tags": {
    "profile_name": "Standard Merchant Profile",
    "tier": "standard",
    "region": "north_america"
  },
  "_links": {
    "self": {
      "href": "https://api.ahrvo.network/payments/na/fee_profiles/FPxxxxxxxxxxxxxxxxxx"
    },
    "application": {
      "href": "https://api.ahrvo.network/payments/na/applications/APxxxxxxxxxxxxxxxxxx"
    }
  }
}

Understanding the Response​

Fee Categories​

The response includes several categories of fees:

  1. Card Fees

    • basis_points and fixed_fee: Base card processing fees
    • Brand-specific fees for Visa, Mastercard, Amex, etc.
    • Cross-border transaction fees

  2. ACH Fees

    • Transaction fees (ach_basis_points, ach_fixed_fee)
    • Return fees (credit and debit)
    • Notice of Change fees

  3. EFT Fees

    • Transaction fees (eft_basis_points, eft_fixed_fee)
    • Return fees (credit and debit)

  4. Dispute Fees

    • Chargeback fees (dispute_fixed_fee)
    • Inquiry fees (dispute_inquiry_fixed_fee)

  5. Settlement Funding Fees

    • ACH and EFT settlement transfer fees

  6. Ancillary Fees

    • Additional service fees

Fee Calculation​

  • Percentage Fees: Expressed in basis points (100 = 1%)
  • Fixed Fees: Expressed in cents
  • Fee Limits: Maximum cap on percentage-based fees
  • Total Fee = (amount × basis_points / 10000) + fixed_fee

API Documentation​