> ## Documentation Index
> Fetch the complete documentation index at: https://docs.terabusinessfinance.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sandbox quick start

> Create a synthetic basic submission against the sandbox host with a test credential.

Sandbox is live. Use it to integrate against the same HTTP contract that production will use, without billing or customer email. Production is not yet live.

## 1. Use a test credential

Staff issue a **test** credential. The secret is shown once. Prefix and host must both be sandbox.

```bash theme={null}
export TERA_SUPPLIER_BASE_URL="https://sandbox-api.terabusinessfinance.com"
export TERA_SUPPLIER_TOKEN="tcs_test_cred_northbridge_REPLACE_WITH_YOUR_SANDBOX_SECRET"
```

Do not send live credentials to the sandbox host.

## 2. Create a basic submission

The example company and applicant are synthetic.

```bash theme={null}
curl -sS -X POST "$TERA_SUPPLIER_BASE_URL/v1/supplier-submissions" \
  -H "Authorization: Bearer $TERA_SUPPLIER_TOKEN" \
  -H "Content-Type: application/json" \
  -H "X-Request-Id: req_northbridge_001" \
  -d @fixtures/basic-create.json
```

A **new** persist returns **202** with `status=received`. Sandbox billing is always `not_billable`.

Repeating the same `external_reference` with the same body returns **200** and the same `submission_id`. See [Idempotency](/guides/idempotency).

## 3. Poll status

```bash theme={null}
curl -sS "$TERA_SUPPLIER_BASE_URL/v1/supplier-submissions?external_reference=northbridge-enq-1001" \
  -H "Authorization: Bearer $TERA_SUPPLIER_TOKEN"
```

Or poll by the `submission_id` from the create response.

## 4. Production is not yet live

The intended production host is `https://api.terabusinessfinance.com`. There is no READY production API deployment and Supplier API production traffic is disabled. Do not point live credentials there yet.

When production is enabled, Tera will issue a live credential. Use that host only, and do not reuse sandbox secrets. See [Key rotation](/guides/key-rotation).