> For the complete documentation index, see [llms.txt](https://kreatorverse-2.gitbook.io/kollect-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kreatorverse-2.gitbook.io/kollect-documentation/api-reference.md).

# API reference

### Application root <a href="#application-root" id="application-root"></a>

The Kollect backend mounts routes at the **application root** (no global `/api/v1`-style prefix in the server entrypoint). All paths in this documentation are **relative to your deployment host**.**Example**

| Environment          | Base URL                                                 |
| -------------------- | -------------------------------------------------------- |
| Sand box environment | `https://kollect-backend-stage-qr574.ondigitalocean.app` |

Replace `<your-kollect-backend-host>` with the hostname your platform team provides.

### Sandbox vs production <a href="#sandbox-vs-production" id="sandbox-vs-production"></a>

The codebase does not define separate “sandbox” and “production” **base URLs** by convention. Instead, **environment separation** is typically achieved through:

* **Different deployments** (staging vs production hosts), and/or
* **Testnet token identifiers** in `invoiceCurrency` and `paymentCurrency` (for example Sepolia variants).

See [Testing & sandbox](/kollect-documentation/guides/testing-and-sandbox.md) for allowed currency strings suitable for non-production testing.

### Full URL examples <a href="#full-url-examples" id="full-url-examples"></a>

| Resource                               | Example path                                          |
| -------------------------------------- | ----------------------------------------------------- |
| S2S create payment                     | `POST SandBox-environment /sdk/server/create-payment` |
| Profile webhook config (Firebase auth) | `POST SandBox-environment/profile/webhook`            |

### TLS <a href="#tls" id="tls"></a>

Production integrations should use **HTTPS** for all traffic. Webhook URLs must be reachable by Kollect’s outbound HTTP client over the public internet (or your agreed network path).

### Related pages <a href="#related-pages" id="related-pages"></a>

* ​[Create payment URL](/kollect-documentation/api-reference/create-payment.md)​
* ​[Testing & sandbox](/kollect-documentation/guides/testing-and-sandbox.md)​
