API Reference - Suby.fi

The v3 API is organized around REST. Resources are plural and live under the /v3 prefix. All requests are authenticated with your API key in the X-Suby-Api-Key header.

Base URL — https://api.beta.suby.fi
Auth — X-Suby-Api-Key: sk_live_… (or sk_sandbox_…)
Envelope — { "success": true, "data": … } / { "success": false, "error": …, "message": … }
Money — integer cents; token amounts as strings in smallest unit
Pagination — cursor-based (?limit=, ?cursor= → pagination.nextCursor)

See Errors & responses for status codes and error codes.

Resources

Group	Description
Payments	Create, capture, void, list, and retrieve payments; receipts.
Subscriptions	Start, retrieve, and cancel subscriptions.
Products	Manage the product catalog + product analytics.
Customers	Customer records, billing address, and customer analytics.
Payment Methods	List and revoke saved customer payment methods.
Setup Intents	Save a payment method for off-session charges.
Checkout Sessions	Signed hosted-checkout tokens.
Checkout Settings	Hosted-checkout branding.
Webhook Endpoints	Register destinations and rotate signing secrets.
Analytics	Org-wide revenue analytics.

Pick an endpoint from the sidebar to see its parameters, request body, and response schema, with a live “Try it” panel.

​Resources

Resources