# Welcome

Artum is a payment API for accepting stablecoin payments on supported chains.

This documentation helps merchants integrate the API, test against the mock environment, and understand the payment lifecycle before moving to production.

## Start Here

* [Quickstart](/get-started/quickstart.md)
* [Core Concepts](/concepts/concepts.md)
* [Authentication](/get-started/authentication.md)
* [Mock API](/mock-api/mock-api.md)
* [Mock Scenarios](/mock-api/mock-scenarios.md)
* [Create a payment](/payments/create-payment.md)
* [API reference](/reference/api-reference.md)

## Current Scope

The current mock environment targets the first BSC payment flow. Public API examples use `bsc-mainnet` as the chain key and stablecoin assets exposed by the mock chain registry.

The mock API is designed for client integration testing. Payment creation, status polling, chain registry, asset registry, and webhook endpoint management are available on the same public routes planned for production.

Webhook delivery is not active in the current mock. Registering webhook endpoints is available so clients can prepare configuration flows, but payment lifecycle changes should be tested by polling until delivery is enabled.

## Source of Truth

The generated OpenAPI document is the schema source of truth:

<https://mock.artum.app/openapi.yaml>

Interactive Swagger is available at:

<https://mock.artum.app/swagger/>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.artum.app/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.