Payment Statistics

​

Overview

GET /payments/stats

​

Authentication

Authorization:  YOUR_API_KEY

​

Response Fields

​

Examples

​

Basic Statistics Request

curl -X GET "https://api.spendjuice.com/payments/stats" \
-H "Authorization:  YOUR_API_KEY"

import requests

response = requests.get(
    'https://api.spendjuice.com/payments/stats',
    headers={'Authorization': ' YOUR_API_KEY'}
)

const response = await fetch('https://api.spendjuice.com/payments/stats', {
  headers: {
    'Authorization': ' YOUR_API_KEY'
  }
});

​

Success Response

{
  "data": {
    "captured": 2,
    "failed": 5,
    "pending": 2,
    "settled": 8,
    "total": 20
  }
}

{
  "data": {
    "captured": 0,
    "failed": 0,
    "pending": 0,
    "settled": 0,
    "total": 0
  }
}

​

Data Aggregation

• Updates in near real-time as payment statuses change
• Includes payments from the last 30 days by default
• Counts each payment exactly once based on its current status
• Excludes test mode payments from production statistics

​

Usage Examples

​

Monitor Payment Success Rate

const stats = await getPaymentStats();
const successRate = (stats.data.settled / stats.data.total) * 100;
console.log(`Payment Success Rate: ${successRate}%`);

​

Track Failed Payments

const stats = await getPaymentStats();
if (stats.data.failed > 0) {
  notifyTeam(`${stats.data.failed} failed payments require attention`);
}

​

Best Practices

1. Caching
   • Cache statistics for up to 5 minutes to reduce API load
   • Implement stale-while-revalidate caching strategy
   • Clear cache when receiving payment webhooks
2. Error Handling
   • Implement exponential backoff for retries
   • Handle network timeouts gracefully
   • Log unusual statistical patterns
3. Monitoring
   • Track success rate trends over time
   • Set up alerts for unusual failure rates
   • Monitor pending payment resolution times