Skip to main content

Organization, Application, and Environment

Organization​

An Organization is the customer company using the platform — the billing, data-isolation, and grouping unit for everything else. Every entity on the platform belongs to exactly one Organization; data never leaks between Organizations.

Create an Organization via POST /v1/organizations.

Application​

An Application is a specific system on your side that integrates with the platform — your website, your mobile app, your backoffice. It's the unit of credentialing (API Key), Workflow configuration, and Transaction creation. An Organization can have multiple Applications.

Create an Application via POST /v1/organizations/{organizationId}/applications.

Environment​

Every Application has, at minimum, two Environments: sandbox and production. Total isolation — no sandbox data influences balance, ledger, or events in production, and vice versa.

Create an Environment via POST /v1/applications/{applicationId}/environments.

API Key​

Every Environment has its own API Key — the credential used to authenticate API calls. An API Key is never shown in full after creation; keep it secure.

Generate an API Key via POST /v1/environments/{environmentId}/api-keys.