Pular para o conteúdo principal

Organization, Application e Environment

Organization

Uma Organization é a empresa cliente da plataforma — a unidade de cobrança, isolamento de dados e agrupamento de todo o resto (Application, Account, Workflow, Transaction). Toda entidade da plataforma pertence a exatamente uma Organization; dados nunca vazam entre Organizations.

Crie uma Organization via POST /v1/organizations.

Application

Uma Application é um sistema específico do seu lado que integra com a plataforma — seu site, seu app mobile, seu backoffice. É a unidade de credenciamento (API Key), configuração de Workflow e criação de Transaction. Uma Organization pode ter múltiplas Applications.

Crie uma Application via POST /v1/organizations/{organizationId}/applications.

Environment

Cada Application tem, no mínimo, dois Environments: sandbox e production. Isolamento total — nenhum dado de sandbox influencia saldo, ledger ou eventos de production, e vice-versa.

Crie um Environment via POST /v1/applications/{applicationId}/environments.

API Key

Cada Environment tem sua própria API Key — a credencial usada para autenticar chamadas à API. Uma API Key nunca é exibida em texto completo após a criação; guarde-a com segurança.

Gere uma API Key via POST /v1/environments/{environmentId}/api-keys.