API overview

One JSON-over-HTTPS REST API for payments across 100+ providers and every major method.

One JSON-over-HTTPS REST API to orchestrate payments across 100+ providers and every major payment method, in any country Yuno supports. Standard HTTP verbs, predictable URLs, JSON in and out — if you’ve used Stripe, this will feel familiar.

Where to start

New to Yuno?

Make your first checkout session against sandbox in under 5 minutes.

Know what you need?

Browse by capability or jump straight to the endpoint reference below.

Install and call

Sandbox: https://api-sandbox.y.uno · Production: https://api.y.uno

A trivial auth-bearing call to confirm your credentials reach the API. List one customer — side-effect free, returns 200 OK.

cURL

curl "https://api-sandbox.y.uno/v1/customers?limit=1" \
  -H "public-api-key: $YUNO_PUBLIC_API_KEY" \
  -H "private-secret-key: $YUNO_PRIVATE_SECRET_KEY"

Node.js

const res = await fetch("https://api-sandbox.y.uno/v1/customers?limit=1", {
  headers: {
    "public-api-key": process.env.YUNO_PUBLIC_API_KEY,
    "private-secret-key": process.env.YUNO_PRIVATE_SECRET_KEY,
  },
});
console.log(await res.json());

Python

import os, requests
res = requests.get(
    "https://api-sandbox.y.uno/v1/customers?limit=1",
    headers={
        "public-api-key": os.environ["YUNO_PUBLIC_API_KEY"],
        "private-secret-key": os.environ["YUNO_PRIVATE_SECRET_KEY"],
    },
)
print(res.json())

Go

req, _ := http.NewRequest("GET", "https://api-sandbox.y.uno/v1/customers?limit=1", nil)
req.Header.Set("public-api-key", os.Getenv("YUNO_PUBLIC_API_KEY"))
req.Header.Set("private-secret-key", os.Getenv("YUNO_PRIVATE_SECRET_KEY"))
res, err := http.DefaultClient.Do(req)

Sample response (200)

List endpoints return a JSON array of resource objects directly — no envelope. An empty account returns [].

[
  {
    "id": "c9d0e1f2-3a4b-5c6d-7e8f-9a0b1c2d3e4f",
    "merchant_customer_id": "cust-internal-001",
    "first_name": "Maria",
    "last_name": "Silva",
    "email": "[e-mail]",
    "country": "BR",
    "created_at": "2026-05-11T14:32:01.482Z",
    "updated_at": "2026-05-11T14:32:01.482Z"
  }
]

Build with Yuno

Accept payments online

Hosted checkout sessions that render Yuno’s SDK and route across providers.

Charge cards server-to-server

Direct API payments for custom UIs and headless flows.

Save cards and tokens

Vault payment methods for one-click checkout and merchant-initiated transactions.

Charge on a schedule

Subscriptions with retry logic and dunning built in.

Offer installments

Country-specific installment plans for cards.

Share payment links

Hosted, single-use checkout URLs you can send by email or chat.

Run a marketplace

Onboard recipients and split payouts across multiple parties.

Embedded finance

Open accounts and move funds via Banking as a Service.

Reference and tools

Authentication

The two required headers and how to keep secrets server-side.

Environments

Sandbox vs production base URLs and isolation guarantees.

Avoiding duplicates

Business keys that make retries safe across every resource.

Errors

The error envelope, the full code catalog, and how to retry safely.

Webhooks

Endpoint registration, signature verification, and lifecycle events.

SDKs

Web, iOS, Android, Flutter, and framework component libraries.

See Conventions for pagination, status codes, rate limits, and async result behavior.

For AI coding agents

OpenAPI 3.1 spec

The full machine-readable contract. Drop into openapi-generator, Stainless, or any compatible client generator.

/llms.txt site index

Plain-markdown index of every documentation page and OpenAPI endpoint, ready for RAG or context loading.

MCP server

Connect Claude Code, Cursor, or any MCP-compatible tool to read these docs and call the API in one session.

Combined, these let an agent both read this documentation and call the API in the same session.

Changelog

API changelog

New endpoints, field additions, and behavior changes.

Versioning policy

How Yuno ships changes and what counts as breaking.