# Authentication

Authenticate every request with an API key in the `Authorization` header:

```
Authorization: Bearer sk_test_...
```

API key. Publishable keys look like `pk_test_...` / `pk_live_...`,
secret keys like `sk_test_...` / `sk_live_...`. Keep secret keys on
your server; never ship them in client-side code.

## Modes

- `*_test_*` keys operate on the sandbox dataset, never real inventory or real money. Fully self-serve; develop end to end without anything real moving.
- `*_live_*` keys operate on production data.

## Scopes

- Publishable keys (`pk_`) are limited to public read scopes regardless of the key's scope list.
- Secret keys (`sk_`) can use every scope granted to them; writes always require a secret key.
- A missing scope fails with `permission_error` / `scope_missing`, naming the scope you need.
