Batch Processing

Upload and process batches of transactions efficiently.

Overview

AuxVault supports two forms of batch operations:

1. Batch Terminal — Upload a CSV/file of transactions through the merchant portal
2. Settlement Batches — Automatic daily settlement batches managed by the platform

Settlement Batches (Auto)

AuxVault automatically settles transactions into daily batches. Settlement is configured per-merchant and runs on the merchant's configured schedule.

Get Current Settlement Schedule

curl https://dev.auxcore.net/api/v1/settlement/schedule/MERCHANT_ID \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Tenant-ID: YOUR_TENANT_ID"

Response:

{
  "success": true,
  "data": {
    "merchantId": "merchant-456",
    "frequency": "daily",
    "time": "23:59",
    "timezone": "America/New_York",
    "nextSettlement": "2026-02-24T23:59:00Z"
  }
}

Update Settlement Schedule

curl -X PUT https://dev.auxcore.net/api/v1/settlement/schedule/MERCHANT_ID \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Tenant-ID: YOUR_TENANT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "frequency": "daily",
    "time": "23:59",
    "timezone": "America/New_York"
  }'

Batch Reports

List Batches

curl "https://dev.auxcore.net/api/v1/reporting/batches?page=1&limit=20" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Tenant-ID: YOUR_TENANT_ID"

Response:

{
  "success": true,
  "data": [
    {
      "batchId": "batch_abc123",
      "status": "settled",
      "transactionCount": 47,
      "totalAmount": 5824.75,
      "settledAt": "2026-02-22T23:59:00Z",
      "merchantId": "merchant-456"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 89
  }
}

Get Batch Details

curl https://dev.auxcore.net/api/v1/reporting/batches/batch_abc123 \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Tenant-ID: YOUR_TENANT_ID"

Batch Terminal (File Upload)

The Batch Terminal allows processing multiple transactions from a file.

Supported File Formats

Required CSV Columns

Example CSV

amount,card_number,expiry_month,expiry_year,cvv,customer_name,customer_email
125.00,4111111111111111,12,2027,123,John Doe,john@example.com
75.50,5555555555554444,06,2026,456,Jane Smith,jane@example.com
200.00,378282246310005,09,2028,7890,Bob Jones,bob@example.com

Settlement Payout

Initiate a Manual Payout

curl -X POST https://dev.auxcore.net/api/v1/settlement/payout \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Tenant-ID: YOUR_TENANT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "merchantId": "merchant-456",
    "amount": 5824.75
  }'

Get Settlement History

curl "https://dev.auxcore.net/api/v1/settlement/history/merchant-456?page=1&limit=20" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Tenant-ID: YOUR_TENANT_ID"

Funding Report

The funding report shows gross sales, processing fees, reserves, and net deposits.

curl "https://dev.auxcore.net/api/v1/settlement/funding-report?merchantId=merchant-456&startDate=2026-02-01&endDate=2026-02-28" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Tenant-ID: YOUR_TENANT_ID"

Export Funding Report as CSV

curl -X POST https://dev.auxcore.net/api/v1/settlement/funding-report/export/csv \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Tenant-ID: YOUR_TENANT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "merchantId": "merchant-456",
    "startDate": "2026-02-01",
    "endDate": "2026-02-28"
  }' \
  -o funding-report.csv

Email Funding Report

curl -X POST https://dev.auxcore.net/api/v1/settlement/funding-report/email \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Tenant-ID: YOUR_TENANT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "merchantId": "merchant-456",
    "startDate": "2026-02-01",
    "endDate": "2026-02-28",
    "email": "accounting@example.com"
  }'

Best Practices

• Test with small batches before uploading large files
• Validate your CSV format before upload to avoid partial failures
• Check batch status after submission — processing can take a few minutes
• Keep batch files for reconciliation purposes
• Use settlement reports to verify all transactions settled correctly

Need help? Contact support@auxvault.com