Development Environment

This section guides you through setting up your development environment, understanding authentication, and exploring the FinHub APIs.

Environment Overview

FinHub provides three environments for your integration journey:

Development Journey

flowchart LR
    A[Sandbox] --> B[Integration]
    B --> C[Production]
    
    A1[Development & Testing] --> A
    B1[Pre-production Validation] --> B
    C1[Live Operations] --> C

Getting Started

1. Sandbox Setup

   Configure your sandbox environment and credentials

2. Authentication

   Implement the authentication flow to get access tokens

3. Playground Exploration

   Use the playground to explore and test APIs

4. Testing Tools

   Set up testing tools and utilities

Quick Start

1. Get Your Credentials

Ensure you have received:

• Tenant ID
• Client ID
• Client Secret
• Sandbox username and password

2. Authenticate

curl -X POST "https://gateway.sandbox.finhub.cloud/api/v2/auth/sandbox/token" \
  -H "Content-Type: application/json" \
  -H "X-Tenant-ID: YOUR_TENANT_ID" \
  -d '{
    "username": "YOUR_USERNAME",
    "password": "YOUR_PASSWORD",
    "customerId": "YOUR_CLIENT_ID",
    "customerSecret": "YOUR_CLIENT_SECRET",
    "accountType": "b2b"
  }'

3. Make Your First API Call

curl -X GET "https://gateway.sandbox.finhub.cloud/api/v2/customers" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "X-Tenant-ID: YOUR_TENANT_ID"

Development Resources