Skip to main content

List Fee Profiles

Suggest Edits

Overview​

Retrieve a list of all fee profiles. A Fee Profile represents a pricing scheme that automatically applies fees to each transaction. Fee profiles define the costs for processing different payment types including card, ACH, EFT transactions, and associated fees like disputes and chargebacks.

Resource Access​

Production (api.ahrvo.network)

GET https://api.ahrvo.network/payments/na/fee_profiles

Staging (gateway.ahrvo.network)

GET http://gateway.ahrvo.network/payments/na/fee_profiles

Arguments​

AttributeMandatory / OptionalDescription
limitOptionalThe number of items to return (default: 10)
after_cursorOptionalReturn every resource created after the cursor value

Example Request​

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

Example Response​

{
  "_embedded": {
    "fee_profiles": [
      {
        "id": "FPxxxxxxxxxxxxxxxxxx",
        "created_at": "2025-12-01T10:00:00Z",
        "updated_at": "2025-12-01T10:00: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"
        },
        "_links": {
          "self": {
            "href": "https://api.ahrvo.network/payments/na/fee_profiles/FPxxxxxxxxxxxxxxxxxx"
          },
          "application": {
            "href": "https://api.ahrvo.network/payments/na/applications/APxxxxxxxxxxxxxxxxxx"
          }
        }
      }
    ]
  },
  "page": {
    "offset": 0,
    "limit": 10,
    "count": 1
  },
  "_links": {
    "self": {
      "href": "https://api.ahrvo.network/payments/na/fee_profiles?limit=10"
    }
  }
}

Understanding Fee Structure​

Fee profiles use basis points and fixed fees:

  • Basis Points: Percentage-based fees (100 basis points = 1%)
  • Fixed Fee: Flat amount in cents per transaction
  • Total Fee: basis_points × amount + fixed_fee

Example: For a $100.00 transaction with 275 basis points and $0.10 fixed fee:

  • Percentage fee: $100.00 × 2.75% = $2.75
  • Fixed fee: $0.10
  • Total fee: $2.85

API Documentation​