• User Documentation 
  • Amaryllis Release Notes 
  • For Developers 

  • User Documentation 
  • Amaryllis Release Notes 
  • For Developers 

Heartland - Dev Portal

  • folder icon closed folder iconIntroduction
  • folder icon closed folder iconAuthentication
  • folder icon closed folder iconManagement
    • Getting Started
    • Platform Accounts Management
      • Get Platform Account Configuration
      • Get Platform Account
      • Create Platform Account
      • Update Platform Account
      • Objects Reference
    • Sub-Accounts Management
      • Get Sub-Account Configurations
      • Get Sub-Account
      • Create Sub-Account
      • Update Sub-Account
      • Objects Reference
    • Users Management
      • Get User by User Id
      • Get User by Username
      • Create User
      • Update User
      • Objects Reference
    • Underwriting Management
      • Get Application
      • Get Application Template
      • Get Application Fields Statuses
      • Get Application Status
      • Get Linked Sub-Accounts
      • Get Resubmission
      • UMS IFrame Authentication
      • UMS IFrame
      • UMS IFrame Authentication in Resubmission Mode
      • UMS IFrame in Resubmission Mode
      • Create Application
      • Update Application
      • Update Application Fields Statuses
      • Update Application Status
      • Objects Reference
      • Response Codes
  • folder icon closed folder iconTransactions Processing
    • Getting Started
    • Credit Card Transactions
      • 3D-Secure
      • Authorization
      • Void
      • Capture
      • Charge
      • Refund
      • Credit
      • Verify
      • Chargeback
      • Cancel
    • Update
    • Adjustment
    • Recurring
    • ACH
    • Response
    • Response Codes
    • Objects Reference
  • folder icon closed folder iconTransactions Echo
    • Getting Started
    • Credit Card Transactions
      • Authorization
      • Void
      • Capture
      • Charge
      • Refund
      • Credit
      • Verify
      • Chargeback
      • Cancel
    • Update
    • Adjustment
    • ACH
    • Echo Response
    • Response Codes
    • Objects Reference
  • folder icon closed folder iconTokenization
    • Processing with a Token
      • Getting Started
      • Processing with Tokenization
    • Tokenization iFrame
      • iFrame Integration
      • iFrame Customization
      • iFrame Testing
      • Response Example
    • Tokenization API
      • Getting Started
      • Tokenization Request
      • Tokenization Response
      • Response Codes
  • folder icon closed folder iconPayouts
    • Getting Started
    • Payout Transactions
    • Response
    • Objects Reference
  • folder icon closed folder iconReports
    • Getting Started
    • Reports API
      • Account Balances
      • Payouts
      • Payouts Reconciliation
      • Transaction Details
      • Settlements
      • Account Summary
      • Transactions
      • Transactions Summary
      • Fees Summary
      • Incoming Fees
      • Expected Future Revenue
      • Profitability Analysis
      • Reconciliation Summary
      • Reconciliation Records
      • Chargeback Analysis
      • Tokens
      • Sign-up Summary
    • Status Codes
  • folder icon closed folder iconErrors
  • folder icon closed folder iconResponse Codes
  1. Home
  2. Docs
  3. Heartland – Dev Portal
  4. Reports
  5. Reports API
  6. Fees Summary
Updated on June 9, 2023

Heartland - Dev Portal

  • folder icon closed folder iconIntroduction
  • folder icon closed folder iconAuthentication
  • folder icon closed folder iconManagement
    • Getting Started
    • Platform Accounts Management
      • Get Platform Account Configuration
      • Get Platform Account
      • Create Platform Account
      • Update Platform Account
      • Objects Reference
    • Sub-Accounts Management
      • Get Sub-Account Configurations
      • Get Sub-Account
      • Create Sub-Account
      • Update Sub-Account
      • Objects Reference
    • Users Management
      • Get User by User Id
      • Get User by Username
      • Create User
      • Update User
      • Objects Reference
    • Underwriting Management
      • Get Application
      • Get Application Template
      • Get Application Fields Statuses
      • Get Application Status
      • Get Linked Sub-Accounts
      • Get Resubmission
      • UMS IFrame Authentication
      • UMS IFrame
      • UMS IFrame Authentication in Resubmission Mode
      • UMS IFrame in Resubmission Mode
      • Create Application
      • Update Application
      • Update Application Fields Statuses
      • Update Application Status
      • Objects Reference
      • Response Codes
  • folder icon closed folder iconTransactions Processing
    • Getting Started
    • Credit Card Transactions
      • 3D-Secure
      • Authorization
      • Void
      • Capture
      • Charge
      • Refund
      • Credit
      • Verify
      • Chargeback
      • Cancel
    • Update
    • Adjustment
    • Recurring
    • ACH
    • Response
    • Response Codes
    • Objects Reference
  • folder icon closed folder iconTransactions Echo
    • Getting Started
    • Credit Card Transactions
      • Authorization
      • Void
      • Capture
      • Charge
      • Refund
      • Credit
      • Verify
      • Chargeback
      • Cancel
    • Update
    • Adjustment
    • ACH
    • Echo Response
    • Response Codes
    • Objects Reference
  • folder icon closed folder iconTokenization
    • Processing with a Token
      • Getting Started
      • Processing with Tokenization
    • Tokenization iFrame
      • iFrame Integration
      • iFrame Customization
      • iFrame Testing
      • Response Example
    • Tokenization API
      • Getting Started
      • Tokenization Request
      • Tokenization Response
      • Response Codes
  • folder icon closed folder iconPayouts
    • Getting Started
    • Payout Transactions
    • Response
    • Objects Reference
  • folder icon closed folder iconReports
    • Getting Started
    • Reports API
      • Account Balances
      • Payouts
      • Payouts Reconciliation
      • Transaction Details
      • Settlements
      • Account Summary
      • Transactions
      • Transactions Summary
      • Fees Summary
      • Incoming Fees
      • Expected Future Revenue
      • Profitability Analysis
      • Reconciliation Summary
      • Reconciliation Records
      • Chargeback Analysis
      • Tokens
      • Sign-up Summary
    • Status Codes
  • folder icon closed folder iconErrors
  • folder icon closed folder iconResponse Codes

Fees Summary

REST Sandbox URL: https://sandbox.4levers.com/NewReportsApi/api/Reports/fees-summary

REST Production URL: https://reports-api.4levers.com/api/Reports/fees-summary

Fees Summary report provides a complete overview of all the fees that have been processed on your Sub-Account on a specific date.

Fees Summary report displays incoming fees for transactions processed by the same Sub-Account, as the fee target Sub-Account.

Request Example (REST Production URL)

GET: https://reports-api.4levers.com/api/Reports/fees-summary?DateFrom=2019-07-23&DateTo=2019-07-24

Request Parameters

 NameTypeRequiredDescription
 datefromdatetime✓determines the selection starting/ending time range
 datetodatetime✓
 feeidinteger/arrayoptionalenter your fee id(s)
 feegroupidinteger/arrayoptionalenter your fee group id(s)
 feetypeenumoptional

select fee type to output in the report

Available Values:
 
  • pertransaction calculated per transaction
  • scalerange calculated per transaction count
  • scheduled calculated on a scheduled basis
  • interchangefee interchange fees
  • feeonfee fees for other fees
 feecategoryenumoptional

nullable

fee categories

Available Values:
 
  • fee
  • tax
 processorsstring/arrayoptionalclearing acquirer name(s)
 feetargetsenumoptional

specify the fee recipient

Available Values:
 
  • platform platform is a fee recipient
  • serviceprovider service provider is a fee recipient
  • operator operator is a fee recipient
  • reservebalance fee assigned to a reserve balance
  • subaccount sub-account is a fee recipient
  • outgoing outgoing fees
  • agent fees for agents
 serviceprovidersinteger/arrayoptionalenter your service provider id(s)
 operatorsinteger/arrayoptionalenter your operator id(s)
 accountsinteger/arrayoptionalenter your platform account id(s)
 subaccountsstring/arrayoptionalenter your sub-account id(s)
 skipintegeroptional

these parameters determine which records will be displayed in the report based on specified index number.

to get from fifth to twentieth record specify skip = 4 and take = 16
 takeintegeroptional
 currenciesstring arrayoptional

enter currency type ids to filter sub-accounts by

Available Values:
 
  • CAD
  • USD
  • EUR
  • GBP
  • AUD
  • SGD
  • JPY
  • NZD

Response Parameters

 NameDescription
 feeDatesystem fee processing date and time
 feenamename of the fee
 feegroupnamename of the fee group
 feetypefee type
 feecategoryfee categories
 transactionidtransaction identifier
 marchanttransactionidtransaction identifier per merchant
 processortransactionidtransaction identifier per processor
 transactiontypetype of transaction a fee has been calculated for
 transactionamounttransaction amount
 pertrxamountfee per transaction fee amount
 pertrxpercentagefee percentage value per transaction
 feeamountfee fixed amount
 currencyfee currency
 feetargetfee recipient
 subaccountsub-account identifier
 platformaccountplatform account name
 billingamount

billing amount value.

used to calculate transaction commissions and fees.

 

				
					[
  {
        "feeDate": "2022-03-04T17:59:59",  
        "feeName": "test_fee", 
        "feeGroupName": "test",    
        "feeType": "Per Transaction Fee",    
        "feeCategory": "Tax",  
        "transactionId": "1588001137083647671",    
        "merchantTransactionId": "69", 
        "processorTransactionId": "90ed214e-8558-4e49-987e-2a56c4e7bbae",  
        "transactionSystemDate": "0001-01-01T00:00:00",    
        "transactionMerchantDate": "2022-03-01T00:00:00",  
        "transactionOrigin": "test_accountId", 
        "transactionType": "Charge",   
        "transactionDescription": "test",  
        "merchantFreeText": "here can be any Merchant Free Text",    
        "paymentMethod": "Visa",   
        "entryMode": "0-Unknown",  
        "transactionAmount": "15.00",  
        "transactionStatus": "Processed",  
        "processor": "Emulator",   
        "terminalId": "t--0123345345345345",   
        "billingAmount": "15.000000",  
        "perTrxAmount": "0.000000",    
        "perTrxPercentage": "10.000000",   
        "feeAmount": "1.500000",   
        "feeTarget": "ti4_sub2",   
        "currency": "USD", 
        "subAccount": "test_account",
        "platformAccount": "test_account"
  },
  {
    "feeDate": "2022-03-04T17:59:59",  
        "feeName": "test_fee", 
        "feeGroupName": "test",    
        "feeType": "Per Transaction Fee",    
        "feeCategory": "Tax",  
        "transactionId": "1588001137083647671",    
        "merchantTransactionId": "69", 
        "processorTransactionId": "90ed214e-8558-4e49-987e-2a56c4e7bbae",  
        "transactionSystemDate": "0001-01-01T00:00:00",    
        "transactionMerchantDate": "2022-03-01T00:00:00",  
        "transactionOrigin": "test_accountId", 
        "transactionType": "Charge",   
        "transactionDescription": "test",  
        "merchantFreeText": "here can be any Merchant Free Text",    
        "paymentMethod": "Visa",   
        "entryMode": "0-Unknown",  
        "transactionAmount": "15.00",  
        "transactionStatus": "Processed",  
        "processor": "Emulator",   
        "terminalId": "t--0123345345345345",   
        "billingAmount": "15.000000",  
        "perTrxAmount": "0.000000",    
        "perTrxPercentage": "10.000000",   
        "feeAmount": "1.500000",   
        "feeTarget": "ti4_sub2",   
        "currency": "USD", 
        "subAccount": "test_account",
        "platformAccount": "test_account"
  }
]				
			
Still stuck? How can we help?
Was this page helpful? Yes No

How can we help?

© Amaryllis Payment Solutions, 2022  All rights reserved.