• 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. Transactions 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

Transactions Summary

REST Sandbox URL: https://sandbox.4levers.com/NewReportsApi/api/Reports/transactions-summary REST Production URL: https://reports-api.4levers.com/api/Reports/transactions-summary Transactions Summary Report provides Sales, Credits and Chargebacks transaction summary and payment method details for the selected time range and system entity.
  • Sales – Charges, Captures, Partial Captures.
  • Credits – Credits, Refunds, Partial Refunds, Cancels.
  • Chargebacks – Chargebacks, Reversals.
  • Amount of Chargebacks – Amount of Chargebacks – Amount of Reversals.
Total Amount - Sales - Credits - Chargebacks. Can have both positive and negative values.
Request Example (REST Production URL)
GET: https://reports-api.4levers.com/api/Reports/transactions-summary?DateFrom=2020-12-10&DateTo=2020-12-22&DateRangeType=SystemDate&Processors={processorId}&ReportPeriodType=Monthly&Currencies=USD&Accounts={accountId}&SubAccounts={subAccountId}&Take=5

Request Parameters

№ Name Type Required Description
1 datefrom datetime ✓ determines the selection starting/ending time range
2 dateto datetime ✓
3 daterangetype enum optional select the output period for the report
Available Values:
  • systemDate
  • merchantDate
  • settlementDate
4 processors integer/array optional enter your processor id(s)
5 reportperiodtype enum optional select the output period for the report
Available Values:
  • daily
  • monthly
6 serviceproviders integer/array optional enter your service provider id(s)
7 operators integer/array optional enter your operator id(s)
8 accounts integer/array optional enter your platform account id(s)
9 subaccounts string/array optional enter your sub-account id(s)
10 skip integer optional 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
11 take integer optional
12 currencies enum optional enter currency type ids to filter sub-account by
Available Values:
  • CAD
  • USD
  • EUR
  • GBP
  • AUD
  • SGD
  • JPY
  • NZD

Responce Parameters

№ Name Description
1 date record date and time
2 paymentmethod transactions payment method
3 numberofsales number of charges, captures, partial captures
4 amountofsales amount of charges, captures, partial captures
5 numberofcredits number of credit, refund, partial refund, cancel
6 amountofcredits amount of credit, refund, partial refund, cancel
7 numberofchargebacks number of chargebacks, reversals
8 amountofchargebacks amount of chargebacks, reversals
9 totalamount sales minus credits minus chargebacks
10 currency transactions currency
11 subaccount sub-account identifier
12 platformaccount platform account name
				
					[
  {
        "date": "2020-07-01",
        "paymentMethod": "Visa",
        "numberOfSales": "308",
        "amountOfSales": "20.00",
        "numberOfCredits": "18",
        "amountOfCredits": "20.00",
        "numberOfChargebacks": "15",
        "amountOfChargebacks": "10.00",
        "totalAmount": "50.00",
        "currency": "USD",
        "subAccount": "Sub-Account Id - Sub-Account Name",
        "platformAccount": "Platform Account Name"
    },
    {
        "date": "2020-07-01",
        "paymentMethod": "Visa",
        "numberOfSales": "10",
        "amountOfSales": "10.00",
        "numberOfCredits": "50",
        "amountOfCredits": "30.00",
        "numberOfChargebacks": "15",
        "amountOfChargebacks": "10.00",
        "totalAmount": "50.00",
        "currency": "USD",
        "subAccount": "Sub-Account Id - Sub-Account Name",
        "platformAccount": "Platform Account Name"
    }
]				
			
Still stuck? How can we help?
Was this page helpful? Yes No

How can we help?

© Amaryllis Payment Solutions, 2022  All rights reserved.