TuCapiDocs

API reference

API reference

The TuCapi Business API is REST: it takes and returns JSON, uses standard HTTP codes and authenticates with a secret API key.

Authentication

Send your secret key in the Authorization: Bearer tcb_sk_live_… header. See Authentication.

Version

Every response has TuCapi-Api-Version: 2026-09-15. Objects only gain fields.

Errors

Errors always have the shape { error: { type, code, message, param, requestId } }. See Errors and limits.

Base URL
URL
https://api.business.tucapi.com/v1
curl "https://api.business.tucapi.com/v1/balance" \  -H "Authorization: Bearer $TUCAPI_KEY"

Resources

Charges

A charge is what you create: an amount with a checkout URL. It can be paid once.

Orders

An order is a single payment attempt. It's created when your customer picks a method at checkout.

Balance

Your available and on-hold balance, in USDT.

Statements

Monthly summaries of the fees we deducted. They are not tax invoices.

Recurring billing

Subscribe your customers to a plan (plans are created in the dashboard). Each installment is a single-use charge with its own `checkoutUrl`, and paying it creates a regular order. PRO and PREMIUM plans only.