Fetch Split Transfer Fees

Overview

Fetch the detailed fee Transfers associated with a specific Split Transfer. This endpoint returns the breakdown of all fees charged for processing the split payment portion.

Resource Access

User Permissions: Admin users only
Endpoint: GET /split_transfers/\{split_transfer_id}/fees

Arguments

Parameter	Type	Required	Description
split_transfer_id	string	Yes (path)	The unique ID of the Split Transfer
limit	integer	No	Maximum number of records to return (default: 10)

Example Request

curl -X GET \
  'https://api.ahrvo.network/payments/na/split_transfers/STsplitTransfer001/fees' \
  -u username:password \
  -H 'Content-Type: application/json'

Example Response

{
  "_embedded": {
    "transfers": [
      {
        "id": "FEfeeTransfer001",
        "created_at": "2023-12-10T14:30:00Z",
        "updated_at": "2023-12-10T14:30:00Z",
        "amount": 120,
        "currency": "USD",
        "type": "FEE",
        "fee_type": "ACH_BASIS_POINTS",
        "subtype": "MERCHANT_FEE",
        "parent_transfer": "STsplitTransfer001",
        "merchant_id": "MUmerchant001",
        "application": "APapplicationExample123",
        "ready_to_settle_at": "2023-12-10T14:30:00Z",
        "tags": {
          "fee_description": "ACH processing fee - 1.6%"
        },
        "_links": {
          "self": {
            "href": "https://api.ahrvo.network/payments/na/transfers/FEfeeTransfer001"
          },
          "split_transfer": {
            "href": "https://api.ahrvo.network/payments/na/split_transfers/STsplitTransfer001"
          },
          "application": {
            "href": "https://api.ahrvo.network/payments/na/applications/APapplicationExample123"
          }
        }
      },
      {
        "id": "FEfeeTransfer002",
        "created_at": "2023-12-10T14:30:00Z",
        "updated_at": "2023-12-10T14:30:00Z",
        "amount": 30,
        "currency": "USD",
        "type": "FEE",
        "fee_type": "ACH_FIXED",
        "subtype": "MERCHANT_FEE",
        "parent_transfer": "STsplitTransfer001",
        "merchant_id": "MUmerchant001",
        "application": "APapplicationExample123",
        "ready_to_settle_at": "2023-12-10T14:30:00Z",
        "tags": {
          "fee_description": "Fixed transaction fee"
        },
        "_links": {
          "self": {
            "href": "https://api.ahrvo.network/payments/na/transfers/FEfeeTransfer002"
          },
          "split_transfer": {
            "href": "https://api.ahrvo.network/payments/na/split_transfers/STsplitTransfer001"
          },
          "application": {
            "href": "https://api.ahrvo.network/payments/na/applications/APapplicationExample123"
          }
        }
      }
    ]
  },
  "page": {
    "offset": 0,
    "limit": 10,
    "count": 2
  },
  "_links": {
    "self": {
      "href": "https://api.ahrvo.network/payments/na/split_transfers/STsplitTransfer001/fees"
    },
    "split_transfer": {
      "href": "https://api.ahrvo.network/payments/na/split_transfers/STsplitTransfer001"
    }
  }
}

Additional Information

Fee Transfers: Individual fee components charged on the split
- Each fee is a separate Transfer record
- Type = FEE
- Deducted from merchant's payout
- Multiple fees may apply to single split
Fee Types:
- ACH_BASIS_POINTS: Percentage-based fee
  - Example: 1.6% of transaction amount
  - Calculated as basis points (160 basis points = 1.6%)
  - Amount varies with split transfer amount
- ACH_FIXED: Flat fee per transaction
  - Example: $0.30 per transaction
  - Same amount regardless of split size
  - Often combined with percentage fee
- CARD_BASIS_POINTS: Card processing percentage
  - For card-based payments
  - Higher than ACH (typically 2.9%)
- CARD_FIXED: Card processing flat fee
  - Example: $0.30 per card transaction
- PLATFORM_FEE: Platform/marketplace fee
  - Revenue for platform operator
  - May be percentage or fixed
- CUSTOM_FEE: Custom fee defined by platform
  - Service fees, premium features, etc.
Subtype: Usually MERCHANT_FEE
- Indicates fee charged to merchant
- Deducted from merchant's settlement
- May also be APPLICATION_FEE (charged to platform)
Amount: Fee amount in cents
- Can be decimal/float for precise calculations
- Example: 120 cents = $1.20
- Negative in settlement (reduces payout)
Parent Transfer: Links back to Split Transfer
- The split_transfer_id passed in request
- Shows which split these fees apply to
Fee Calculation Example:
- Split Transfer: $75.00 (7,500 cents)
- Fees:
  - ACH_BASIS_POINTS (1.6%): $1.20 (120 cents)
  - ACH_FIXED: $0.30 (30 cents)
  - Total Fees: $1.50 (150 cents)
- Net to Merchant: $75.00 - $1.50 = $73.50
Multiple Fee Components:
- Common to have 2+ fees per split
- Examples:
  - Percentage + Fixed fee
  - Platform fee + Processing fee
  - Monthly fee + Transaction fee
- Sum of all fee amounts = total fee on split
Use Cases:
- Merchant Transparency:
  - Merchant asks why they received $73.50 instead of $75.00
  - Show detailed fee breakdown
  - Explain each fee type and amount
  - Build trust with transparent pricing
- Fee Reconciliation:
  - Verify fee calculations correct
  - Check each fee type applied properly
  - Ensure fee profile followed
  - Audit for compliance
- Reporting & Analytics:
  - Generate fee revenue reports
  - Break down by fee type
  - Track percentage vs fixed fee revenue
  - Analyze fee profitability
- Dispute Resolution:
  - Merchant disputes fee amount
  - Show detailed breakdown
  - Explain fee structure from agreement
  - Verify no errors in calculation
- Fee Profile Testing:
  - Test new fee structures
  - Verify correct fees applied
  - Compare expected vs actual
  - Debug fee configuration issues
Fee Profile Connection:
- Fees determined by merchant's fee_profile_id
- Fee profile defines:
  - Which fee types to charge
  - Percentage rates
  - Fixed amounts
  - Fee minimums/maximums
- Same split amount may have different fees for different merchants
Settlement Impact:
- Fees reduce merchant's net payout
- Example settlement entry:
  - Split Transfer: +$75.00 (credit to merchant)
  - Fee 1: -$1.20 (debit from merchant)
  - Fee 2: -$0.30 (debit from merchant)
  - Net Settlement: $73.50
Common Fee Structures:
- Standard Card Processing:
  - 2.9% + $0.30 per transaction
  - Split: $100 → Fees: $2.90 + $0.30 = $3.20
- ACH Processing:
  - 1.6% + $0.30 per transaction
  - Split: $100 → Fees: $1.60 + $0.30 = $1.90
- Marketplace Model:
  - Platform fee: 10% of split
  - Processing fee: 2.9% + $0.30
  - Split: $100 → Platform: $10.00, Processing: $3.20
  - Merchant nets: $86.80
- Volume-Based Pricing:
  - High volume: 1.5% + $0.25
  - Low volume: 2.9% + $0.30
  - Fees vary by merchant tier
Fee Transfer Properties:
- type: Always FEE
- fee_type: Specific fee category (ACH_BASIS_POINTS, etc.)
- amount: Fee amount in cents (positive value)
- parent_transfer: The split transfer being charged
- merchant_id: Merchant being charged
- ready_to_settle_at: When fee settles (typically same as split)
Related Endpoints:
- GET /split_transfers/{id}: View split transfer and summary fee
- GET /transfers/{fee_id}: Individual fee transfer details
- GET /merchants/{id}/fee_profile: Merchant's fee configuration
- GET /settlements/{id}/entries: Fees in settlement context
Best Practices:
- Display fee breakdown in merchant dashboard
- Provide fee calculator for merchants to estimate costs
- Document fee structures clearly in merchant agreements
- Monitor fee accuracy with automated reconciliation
- Alert on unexpected fee amounts
- Track fee changes over time for merchants
Fee Reversal: If split transfer refunded
- Fee transfers also reversed
- Merchant credited back the fees
- New fee transfer records with negative amounts
- Or original fees marked as reversed

Overview​

Resource Access​

Arguments​

Example Request​

Example Response​

Additional Information​

Overview

Resource Access

Arguments

Example Request

Example Response

Additional Information