API Reference — MutoPay Docs

MutoPay publishes an OpenAPI 3.1 specification. Use it interactively, or pipe it into your codegen tool of choice.

Interactive reference

mutopay.com/api/docs — Scalar-powered browser UI. Try endpoints live with your own API key, inspect request/response schemas, and copy cURL snippets.

Raw OpenAPI spec

mutopay.com/api/openapi.json — OpenAPI 3.1 JSON. Point any client generator at this URL.

# Example: generate a TypeScript client
npx @hey-api/openapi-ts -i https://mutopay.com/api/openapi.json -o ./src/mutopay-client

# Example: generate a Python client
openapi-python-client generate --url https://mutopay.com/api/openapi.json

Authentication in the spec

Two security schemes are declared:

Scheme	Use
`X-API-Key` (channel keys, prefix `ep_`)	Payment creation
`Bearer` (master keys, prefix `msk_`)	Account management under `/api/merchant/*`

Most codegen tools will surface these as typed parameters on the generated client. See Authentication for the plain-English explanation of when to use which.

Base URL

https://mutopay.com

There is no sandbox/test server — use small amount_usd values (≤ $1) on your own test channel while developing.

Prefer plain docs?

Getting Started — end-to-end walkthrough.
Create a Payment — the most common endpoint, with full examples.
Webhooks — event reference.
llms-full.txt — every doc on this site, concatenated and LLM-ready.