Transactions Dashboard

​

Transaction Overview

​

What are x402 Transactions?

• Challenge - API requests payment for access
• Response - Agent provides payment proof
• Settlement - Transaction completes and records usage

​

Viewing Transaction History

​

Transaction Table Columns

• Unique transaction identifier
• Format: tx_[random_string]
• Displayed in monospace font for easy copying

• HTTP method and API endpoint path
• Format: METHOD /path/to/endpoint
• Examples:
  • POST /v1/agents
  • GET /v1/transactions
  • PUT /v1/agents/123

• Transaction cost in USD
• Formatted as currency (e.g., $0.10,$1.50)
• Price charged for this specific API request

• Current transaction state
• Displayed as a colored badge
• See Transaction Statuses below

• Timestamp of last status change
• Human-readable format
• Example: “Jan 15, 2026 2:30 PM”

​

Transaction Table Example

ID                  Endpoint               Amount    Status      Updated
tx_1234567890      POST /v1/agents        $0.10     completed   Jan 15, 2:30 PM
tx_0987654321      GET /v1/orders         $0.05     completed   Jan 15, 2:28 PM
tx_abcdef12345     PUT /v1/agents/1       $0.08     pending     Jan 15, 2:25 PM

​

Transaction Statuses

​

Status Types

• Payment successfully processed
• API request was fulfilled
• Credits deducted from account
• Final state for successful transactions

• Payment in progress
• Awaiting blockchain confirmation
• Challenge issued but not yet settled
• May transition to completed or failed

• Payment unsuccessful
• API request was not fulfilled
• Credits not deducted
• Possible reasons:
  • Insufficient balance
  • Network error
  • Invalid payment proof
  • Timeout

• Server issued payment request
• Agent has not yet responded
• Awaiting payment proof
• Will timeout if no response

​

x402 Transaction Details

​

Transaction Lifecycle

1. Agent Makes Request
   • Agent calls paid API endpoint
   • Request includes no payment initially
2. Server Issues Challenge
   • API responds with 402 Payment Required
   • Includes payment details (amount, address)
   • Transaction status: challenged
3. Agent Provides Payment
   • Agent wallet signs payment transaction
   • Submits payment proof to server
   • Transaction status: pending
4. Server Validates Payment
   • Verifies payment on blockchain
   • Confirms amount and recipient
   • Checks signature validity
5. Transaction Settles
   • Payment accepted
   • API request fulfilled
   • Transaction status: completed
   • Usage event recorded

​

Challenge-Response Flow

​

Usage Events

​

What are Usage Events?

• Record of API consumption
• Billing line item
• Cost breakdown per request
• Timestamp for audit trail

​

Viewing Usage Events

​

Usage Event Details

• Unique identifier for the usage event
• Format: ue_[random_string]

• API endpoint that was accessed
• HTTP method and path

• Amount charged for this request
• Formatted as currency
• Deducted from account credits

• When the usage event was recorded
• Corresponds to transaction settlement time

​

Usage Events Table Example

Event               Endpoint                  Cost      Time
ue_1234567890      POST /v1/agents           $0.10     Jan 15, 2:30 PM
ue_0987654321      GET /v1/transactions      $0.05     Jan 15, 2:28 PM
ue_abcdef12345     POST /v1/api-keys         $0.03     Jan 15, 2:25 PM

​

Filtering and Search

​

Planned Features

• Filter by status (completed, pending, failed)
• Filter by date range
• Search by transaction ID
• Filter by endpoint
• Filter by agent
• Export to CSV

​

Transaction Monitoring

​

Real-Time Updates

• Refresh the page to see latest transactions
• Status updates automatically as transactions progress
• New transactions appear at the top of the list

​

Monitoring Best Practices

​

Common Monitoring Tasks

1. Check Recent Activity
   • View latest transactions to confirm agent operations
   • Verify expected API calls are occurring
2. Identify Issues
   • Look for failed transactions
   • Check for stuck pending transactions
   • Monitor error patterns
3. Cost Analysis
   • Review amounts per endpoint
   • Calculate total spending
   • Identify expensive operations
4. Audit Trail
   • Maintain record of all payments
   • Track transaction timestamps
   • Verify billing accuracy

​

Understanding Costs

​

Per-Request Pricing

• Prices shown in the Amount column
• Charged per successful request
• Failed transactions incur no cost

​

Cost Breakdown

1. API Request Fees - Per-endpoint charges
2. Blockchain Gas Fees - Transaction costs (if applicable)
3. Platform Fees - ActumX service fees (if applicable)

​

Optimizing Costs

• Cache responses when possible
• Batch operations where supported
• Use appropriate endpoints (don’t over-fetch data)
• Monitor usage patterns to identify optimization opportunities

​

Troubleshooting

​

Pending Transactions Stuck

• Blockchain confirmation delay
• Network congestion
• Payment verification in progress

1. Wait 1-2 minutes for normal processing
2. Refresh the page to check status
3. Check Solana network status
4. Contact support if stuck longer than 5 minutes

​

Failed Transactions

• Insufficient wallet balance
• Invalid payment signature
• Network timeout
• API endpoint error

1. Check Balance - Ensure agent wallet has sufficient SOL
2. Fund Wallet - Add funds via Dashboard
3. Retry Request - Agent should automatically retry
4. Check Logs - Review application logs for errors

​

Transaction Not Appearing

1. Refresh the page
2. Check if request reached the API (check application logs)
3. Verify agent is configured correctly
4. Ensure API endpoint requires payment (uses x402)

​

Amount Discrepancy

1. Compare Amount to expected endpoint pricing
2. Check if pricing has changed
3. Verify transaction ID matches usage event
4. Contact support with transaction ID if amount is incorrect

​

Transaction Data Retention

• Complete audit trail available
• No automatic deletion
• Historical data for compliance and analysis

​

Security and Privacy

​

Transaction Security

• All payment proofs are cryptographically signed
• Blockchain verification ensures payment authenticity
• Cannot be replayed or forged

​

Data Access

• Only you can view your transactions
• API keys provide access to transaction data
• Secure HTTPS connections only

​

Integration with Other Pages

​

Related Dashboard Sections

• View overall credit balance
• Top up credits for future transactions
• Review payment intent history

• Detailed cost breakdown per event
• Endpoint-specific usage analytics
• Time-based usage reports

• Quick view of recent transactions
• Agent balance overview
• Link to full transaction history

​

API Access

curl https://api.actumx.ai/v1/transactions \
  -H "Authorization: Bearer axk_your_api_key_here"

​

Response Format

{
  "transactions": [
    {
      "id": "tx_1234567890",
      "method": "POST",
      "endpoint": "/v1/agents",
      "amountCents": 10,
      "status": "completed",
      "updatedAt": "2026-01-15T14:30:00Z"
    }
  ]
}

​

Next Steps

• View usage events
• Understand x402 protocol
• Fund agent wallets
• Manage billing and credits
• View activity API reference