Testing Tools

This guide covers tools and utilities available for testing your FinHub integration.

Available Tools

Sandbox Test Data

The sandbox includes pre-configured test data:

Test Utilities API

Use the Test Utilities API for sandbox-specific operations:

Testing Workflows

Customer Flow Testing

# Create a test customer with pre-approved KYC
curl -X POST "/api/v2/test/customers/create" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"type": "individual", "kycStatus": "approved"}'

Transaction Testing

# Simulate an incoming transfer
curl -X POST "/api/v2/test/transactions/simulate" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"type": "credit", "amount": 1000, "currency": "EUR", "accountId": "acc_123"}'

Webhook Testing

Local Development

Use tools like ngrok to expose local webhooks:

ngrok http 3000
# Use the generated URL as your webhook endpoint

Webhook Simulator

Trigger webhook events from the Developer Portal:

1. Go to Settings > Webhooks
2. Click Test Webhook
3. Select event type
4. Click Send Test

Postman Collection

Import the FinHub Postman collection for comprehensive API testing:

1. Download collection from Developer Portal
2. Import into Postman
3. Configure environment variables
4. Run pre-built test sequences

Automated Testing

Integration Tests

Example test structure:

describe('Customer Registration', () => {
  it('should create individual customer', async () => {
    const response = await api.post('/customers/individual', {
      firstName: 'Test',
      lastName: 'User',
      email: 'test@example.com'
    });
    expect(response.status).toBe(201);
    expect(response.data.id).toBeDefined();
  });
});

Next Steps