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

# Environments

> Sandbox and Production API hosts, isolation, and promotion guidance.

AgentBank has two fully isolated API environments. Select the base URL before
onboarding a merchant or storing any integration state.

| Environment | API base URL | Intended use |
| - | - | - |
| Sandbox | `https://staging-protocol.agentbank.world` | Build, test webhooks, validate KYC integration, and exercise payment flows |
| Production | `https://protocol.useagentbank.com` | Live merchant onboarding and customer payments |

Set `AGENTBANK_BASE_URL` in trusted backend configuration to the selected URL.
Every API path is relative to it: signed Partner routes use `/v1/partner/*`,
portal routes use `/v1/merchant/*`, and public discovery routes use `/api/*`.

## Environment isolation

Sandbox and Production do not share any merchant resource or credential:

* merchant IDs and Ed25519 key registrations
* portal usernames, passwords, and JWTs
* webhook endpoint IDs and HMAC signing secrets
* end-user IDs, KYC versions, rail readiness, payment IDs, and payment history

Register the merchant again in Production, use a Production-only key pair or
securely provisioned Production key, register Production webhook endpoints, and
repeat KYC/payment testing with approved live procedures before go-live.

## Configuration

Do not make the base URL user-controlled. Pin it in trusted backend
configuration and allow only HTTPS outbound traffic to the selected host.