Skip to main content
GHL MCP Guide
TRN

Transactions

Payments & Billing · Intermediate · Updated March 2026

List and retrieve payment transaction records with amounts, dates, and processing details for revenue monitoring and reconciliation.

Transactions gives you access to the raw payment data flowing through a GHL sub-account. Every charge, every payment, every refund — this is the financial record of what actually moved through the payment processor.

What This MCP Tool Does

This tool retrieves payment transaction records with amounts, dates, processing details, and status. Use it for revenue dashboards, reconciliation with external accounting systems, and monitoring payment health across client accounts.

Endpoint Reference

List transactions: GET /payments/transactions Retrieve transaction records with filtering and pagination.

Get transaction by ID: GET /payments/transactions/{transactionId} Retrieve full details for a specific transaction.

Authentication

Requires a Private Integration Token (PIT) with the payments scope enabled.

Key Parameters

Transaction records include:

  • id — unique transaction identifier
  • amount — transaction amount in smallest currency unit
  • currency — currency code
  • status — transaction status (succeeded, failed, refunded, pending)
  • type — transaction type (charge, refund, subscription payment)
  • contactId — associated customer
  • createdAt — transaction timestamp

Important Notes

Transaction data is read-only. You cannot create, modify, or reverse transactions through this endpoint. Payment operations happen through the checkout flow, invoice payments, or subscription billing.

Amounts are in the smallest currency unit (cents for USD). A transaction amount of 9900 means $99.00.

For agencies building revenue dashboards, transaction data provides the ground truth for what money actually moved. Combine with Order Manager for order-level detail and Subscriptions for recurring revenue tracking.

Common Questions

How do I calculate monthly revenue for a client? Filter transactions by date range and status (succeeded only). Sum the amounts. This gives you gross revenue before fees.

Can I see payment processor fees? Transaction records may include fee information depending on the processor integration. Check the response fields for fee breakdowns.

How do I reconcile GHL transactions with Stripe? Each transaction should include processor-specific identifiers. Match these against your Stripe dashboard or API data for reconciliation.

Back to GHL MCP Guide