Batch Processing

When to Use Batch Processing

Perfect for:

• 🏦 End-of-day processing - Verify all pending payments at once
• 📊 Bulk imports - Process large customer databases
• 🔄 Regular reconciliation - Daily/weekly verification runs
• ⚡ High-volume periods - Handle payment spikes efficiently

Simple Batch Request

{
  "batchId": "DAILY_BATCH_20241220",
  "verifications": [
    {
      "id": "TXN_001",
      "iban": "DE89370400440532013000",
      "name": "John Smith"
    },
    {
      "id": "TXN_002",
      "iban": "FR1420041010050500013M02606",
      "name": "Marie Dubois"
    }
    // ... up to 10,000 records
  ]
}

Batch Limits

📊 Processing Capacity

• Up to 10,000 verifications per batch
• Multiple batches can run simultaneously
• Results in 5-15 minutes depending on size
• 99.9% success rate for valid requests

⏱️ Processing Times

Batch Size	Typical Time	Maximum Time
1-1,000	2-5 minutes	10 minutes
1,000-5,000	5-10 minutes	15 minutes
5,000-10,000	10-15 minutes	20 minutes

Check Batch Status

# Check if your batch is complete
curl -X GET https://localhost:8443/api/v1/batch/DAILY_BATCH_20241220 \
  --cert client.crt --key client.key

Response:

{
  "batchId": "DAILY_BATCH_20241220",
  "status": "COMPLETED",
  "progress": {
    "total": 5000,
    "processed": 5000,
    "successful": 4987,
    "failed": 13
  },
  "resultsReady": true
}

Get Batch Results

# Download your results
curl -X GET https://localhost:8443/api/v1/batch/DAILY_BATCH_20241220/results \
  --cert client.crt --key client.key

Results format:

{
  "batchId": "DAILY_BATCH_20241220",
  "results": [
    {
      "id": "TXN_001",
      "result": "MATCH",
      "confidence": "HIGH"
    },
    {
      "id": "TXN_002",
      "result": "NO_MATCH",
      "confidence": "HIGH",
      "reason": "Name mismatch"
    }
  ]
}

Best Practices

✅ Do This

• Validate IBANs before submitting batch
• Use unique IDs for each verification request
• Check status regularly until batch completes
• Handle failed verifications appropriately

❌ Avoid This

• Don’t submit duplicate verifications
• Don’t exceed 10,000 records per batch
• Don’t ignore failed verifications
• Don’t submit invalid IBAN formats

Error Handling

Common Issues:

{
  "error": "BATCH_TOO_LARGE",
  "message": "Batch exceeds 10,000 record limit",
  "action": "Split into smaller batches"
}

{
  "error": "INVALID_IBAN",
  "message": "Invalid IBAN format in record TXN_123",
  "action": "Fix IBAN format and resubmit"
}