Sandbox quick start

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.

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.

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.

3. Poll status

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.

Get started

Submit enquiries

After you submit

Errors and limits

1. Use a test credential

2. Create a basic submission

3. Poll status

4. Production is not yet live

​1. Use a test credential

​2. Create a basic submission

​3. Poll status

​4. Production is not yet live

1. Use a test credential

2. Create a basic submission

3. Poll status

4. Production is not yet live