Transactions
Track all financial transactions on your Audian account.
Get All Transactions​
Retrieve a list of all transactions for your account.
Endpoint​
GET https://api.audian.com:8443/v2/billing/transactions
Parameters​
| Parameter | Type | Required | Description |
|---|---|---|---|
type | string | No | Filter by type (charge, payment, credit, refund) |
status | string | No | Filter by status (pending, completed, failed) |
limit | integer | No | Maximum results (default: 20, max: 100) |
offset | integer | No | Pagination offset |
start_date | string | No | Filter by date range (ISO 8601) |
end_date | string | No | Filter by date range (ISO 8601) |
Request Example​
curl -X GET 'https://api.audian.com:8443/v2/billing/transactions?type=charge&limit=20' \
-H 'X-Auth-Token: YOUR_API_KEY'
Response​
{
"success": true,
"data": {
"transactions": [
{
"id": "txn_abc123",
"type": "charge",
"description": "SMS charges for January 2024",
"amount": 12.34,
"currency": "USD",
"status": "completed",
"created_at": "2024-02-01T10:30:00Z",
"reference": "inv_abc123"
},
{
"id": "txn_abc124",
"type": "payment",
"description": "Payment received",
"amount": 150.75,
"currency": "USD",
"status": "completed",
"created_at": "2024-02-15T14:22:00Z",
"reference": "inv_abc123",
"payment_method": "visa_****1234"
},
{
"id": "txn_abc125",
"type": "credit",
"description": "Account credit applied",
"amount": 50.00,
"currency": "USD",
"status": "completed",
"created_at": "2024-02-16T08:15:00Z",
"reference": "promo_code_2024"
}
],
"total": 247,
"limit": 20,
"offset": 0
}
}
Transaction Types​
| Type | Description |
|---|---|
charge | Monthly billing charge |
payment | Customer payment received |
credit | Account credit applied |
refund | Refund issued to customer |
adjustment | Manual billing adjustment |
fee | Additional service fee |
Transaction Statuses​
| Status | Description |
|---|---|
pending | Transaction is being processed |
completed | Transaction has completed successfully |
failed | Transaction failed to complete |
cancelled | Transaction was cancelled |
reversed | Transaction was reversed |
Get Specific Transaction​
Retrieve details for a specific transaction.
Endpoint​
GET https://api.audian.com:8443/v2/billing/transactions/{transaction_id}
Request Example​
curl -X GET 'https://api.audian.com:8443/v2/billing/transactions/txn_abc123' \
-H 'X-Auth-Token: YOUR_API_KEY'
Response​
{
"success": true,
"data": {
"id": "txn_abc123",
"type": "charge",
"status": "completed",
"description": "Monthly service charges",
"amount": 150.75,
"currency": "USD",
"created_at": "2024-02-01T10:30:00Z",
"processed_at": "2024-02-01T10:35:00Z",
"reference": "inv_abc123",
"invoice_id": "inv_abc123",
"items": [
{
"description": "Phone Numbers (10 x $0.99)",
"amount": 9.90
},
{
"description": "SMS Messages (1234 x $0.01)",
"amount": 12.34
},
{
"description": "Voice Minutes (456 x $0.02)",
"amount": 9.12
}
]
}
}
Payment Transactions​
View all payments made to your account.
Endpoint​
GET https://api.audian.com:8443/v2/billing/transactions?type=payment
Response​
{
"success": true,
"data": {
"transactions": [
{
"id": "txn_abc124",
"type": "payment",
"description": "Payment received via credit card",
"amount": 150.75,
"currency": "USD",
"status": "completed",
"created_at": "2024-02-15T14:22:00Z",
"payment_method": "visa_****1234",
"invoice_id": "inv_abc123"
}
]
}
}
Charge Transactions​
View all charges applied to your account.
Endpoint​
GET https://api.audian.com:8443/v2/billing/transactions?type=charge
Charge Details​
Each charge transaction includes:
- Description: What was charged
- Amount: Total charge amount
- Created At: When charge was created
- Items: Breakdown of charges
Credit Transactions​
View all credits applied to your account.
Endpoint​
GET https://api.audian.com:8443/v2/billing/transactions?type=credit
Credit Sources​
Credits can come from:
- Promotional codes or campaigns
- Account credits from referrals
- Manual credits from Audian support
- Overpayment credits
Refund Transactions​
View all refunds issued to your account.
Endpoint​
GET https://api.audian.com:8443/v2/billing/transactions?type=refund
Refund Status​
- Pending: Refund has been issued but not yet processed
- Completed: Refund has been received by your payment method
- Failed: Refund could not be processed
Transaction History Export​
Export your transaction history for accounting purposes.
Endpoint​
GET https://api.audian.com:8443/v2/billing/transactions/export
Parameters​
| Parameter | Type | Required | Description |
|---|---|---|---|
format | string | No | Export format (csv, json) - default: csv |
start_date | string | Yes | Start date (ISO 8601) |
end_date | string | Yes | End date (ISO 8601) |
Request Example​
curl -X GET 'https://api.audian.com:8443/v2/billing/transactions/export?format=csv&start_date=2024-01-01&end_date=2024-01-31' \
-H 'X-Auth-Token: YOUR_API_KEY' \
-o transactions.csv
Filter by Date Range​
Get transactions within a specific time period.
Request Example​
# Get all transactions from January 2024
curl -X GET 'https://api.audian.com:8443/v2/billing/transactions?start_date=2024-01-01&end_date=2024-01-31' \
-H 'X-Auth-Token: YOUR_API_KEY'
Monthly Summary​
Get a summary of transactions for a specific month.
Endpoint​
GET https://api.audian.com:8443/v2/billing/transactions/summary
Parameters​
| Parameter | Type | Required | Description |
|---|---|---|---|
month | string | Yes | Month in YYYY-MM format |
Request Example​
curl -X GET 'https://api.audian.com:8443/v2/billing/transactions/summary?month=2024-01' \
-H 'X-Auth-Token: YOUR_API_KEY'
Response​
{
"success": true,
"data": {
"month": "2024-01",
"total_charges": 150.75,
"total_payments": 150.75,
"total_credits": 0.00,
"total_refunds": 0.00,
"net_balance": 0.00,
"transaction_count": 5
}
}
Payment Methods​
View payment methods associated with transactions.
Payment Method Information​
From transaction data:
- visa_****1234: Visa ending in 1234
- amex_****5678: American Express ending in 5678
- ach_****0123: ACH account ending in 0123
Reconciliation​
Use transaction data for accounting reconciliation:
- Export transactions for period
- Match charges to invoices
- Verify payments received
- Account for credits and refunds
- Reconcile to accounting system
Best Practices​
- Monitor Regularly: Review transactions weekly
- Verify Charges: Match to invoices and usage
- Export Records: Maintain copies for accounting
- Track Credits: Monitor promotional codes and credits
- Report Issues: Flag unexpected transactions immediately
Troubleshooting​
| Issue | Solution |
|---|---|
| Transaction not showing | Wait 24-48 hours for processing |
| Wrong amount charged | Check invoice for itemization |
| Payment marked failed | Contact support with transaction ID |
| Missing transaction | Check date filters and status |
FAQ​
Q: When will a payment appear in my transaction history? A: Typically within 1-2 business days of payment.
Q: Can I dispute a transaction? A: Yes, contact support within 30 days with details.
Q: How long are transactions retained? A: Transactions are available for 7 years.
Q: Can I get a transaction receipt? A: Yes, download the associated invoice PDF.
Q: Are there fees for transactions? A: No, there are no additional fees for transactions.