• 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. Expected Future Revenue
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

Expected Future Revenue

REST Sandbox URL: https://sandbox.4levers.com/NewReportsApi/api/Reports/expected-future-revenue

REST Production URL: https://reports-api.4levers.com/api/Reports/expected-future-revenue

Expected Future Revenue report provides overview of all due fees, fees with billing delay and fees before the Cut-off.

Request Example (REST Production URL)

GET: https://reports-api.4levers.com/api/Reports/expected-future-revenue?DateFrom=2020-06-01&DateTo=2020-07-17

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
 feesourcesenumoptional

specify the fee source

Available Values:
 
  • disabled for platform user.
  • available for full view only.
  • platform platform account is a fee recipient
  • serviceprovider service provider is a fee recipient
  • operator operator is a fee recipient
  • reservebalance fees for reserve balance
  • subaccount sub-account is a fee recipient
  • outgoing outgoing fees
  • agents fees for agent entities
 processorsstring/arrayrequiredprocessor name(s)
 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
 feeDueDatedue date and time
 feenamename of the fee
 feegroupnamename of the fee group a fee belongs too
 feetypefee type
 feecategoryfee categories
 transactionidtransaction identifier
 transactiontypetype of transaction a fee has been calculated for
 transactionamountrelevant transaction amount
 pertrxamountfee per transaction amount value
 pertrxpercentagefee percentage value per transaction
 feeamountfee fixed amount
 currencyfee currency
 feesourcesource of the fee.
 subaccountsub-account identifier
 platformaccountplatform account name
 billingamount
billing amount.used to calculate transaction commissions and fees.
				
					[
  {
        "feeDueDate": "2022-03-04T14:59:59",       
        "feeName": "test",     
        "feeGroupName": "pertrx mark",        
        "feeType": "Per Transaction Fee",        
        "feeCategory": "Tax",      
        "transactionId": "1588001137083647673",        
        "merchantTransactionId": "71",     
        "processorTransactionId": "pr123",     
        "transactionSystemDate": "0001-01-01T00:00:00",        
        "transactionMerchantDate": "2022-03-01T00:00:00",      
        "transactionOrigin": "1588.3 - ti4_sub3",        
        "transactionType": "Charge",       
        "transactionDescription": "test",      
        "merchantFreeText": "here can be any Merchant Free Text",        
        "paymentMethod": "Visa",       
        "entryMode": "0-Unknown",      
        "transactionAmount": "15.00",      
        "transactionStatus": "Processed",      
        "processor": "ProPay",     
        "terminalId": "t--0123345345345345",       
        "billingAmount": "0.134814",       
        "perTrxAmount": "0.000000",        
        "perTrxPercentage": "100.000000",      
        "feeAmount": "-0.134814",      
        "currency": "USD",     
        "feeSource": "T_ilim4",        
        "subAccount": "testAccount",       
        "platformAccount": "testAccount"       
    },
    {
        "feeDueDate": "2022-03-04T14:59:59",       
        "feeName": "test",     
        "feeGroupName": "pertrx mark",        
        "feeType": "Per Transaction Fee",        
        "feeCategory": "Tax",      
        "transactionId": "1588001137083647673",        
        "merchantTransactionId": "71",     
        "processorTransactionId": "pr123",     
        "transactionSystemDate": "0001-01-01T00:00:00",        
        "transactionMerchantDate": "2022-03-01T00:00:00",      
        "transactionOrigin": "1588.3 - ti4_sub3",        
        "transactionType": "Charge",       
        "transactionDescription": "test",      
        "merchantFreeText": "here can be any Merchant Free Text",        
        "paymentMethod": "Visa",       
        "entryMode": "0-Unknown",      
        "transactionAmount": "15.00",      
        "transactionStatus": "Processed",      
        "processor": "ProPay",     
        "terminalId": "t--0123345345345345",       
        "billingAmount": "0.134814",       
        "perTrxAmount": "0.000000",        
        "perTrxPercentage": "100.000000",      
        "feeAmount": "-0.134814",      
        "currency": "USD",     
        "feeSource": "T_ilim4",        
        "subAccount": "testAccount",       
        "platformAccount": "testAccount"
    }
]				
			
Still stuck? How can we help?
Was this page helpful? Yes No

How can we help?

© Amaryllis Payment Solutions, 2022  All rights reserved.