Voltar
Fortbix
Documentação da API

Conta

Endpoint real de abertura de conta global no backend fortbix-global-account-api.

Cria o customer no provedor e registra a conta global em USD para o tenant autenticado.

REQUEST BODYapplication/json
{
  "businessLegalName": "Acme Corporation Inc.",
  "country": "USA",
  "onboardingFlow": "direct",
  "registeredDate": "2024-01-01",
  "website": "https://acme.com",
  "industry": "Technology",
  "taxIdentificationNumber": "12-3456789",
  "naicsCode": "541511",
  "businessEntityType": "Corporation",
  "businessEntityId": "BE001",
  "businessDescription": "Provider of industrial widgets and services",
  "purposeOfAccount": "Operating expenses and payroll",
  "email": "admin@acme.com",
  "phone": "+1234567890",
  "isOperating": true,
  "isSubsidiary": false,
  "isFinancialInstitution": false,
  "regulatorName": "SEC",
  "registeredAddress": {
    "streetLine1": "456 Office Ave",
    "streetLine2": "Suite 200",
    "city": "New York",
    "state": "NY",
    "postalCode": "10002",
    "country": "USA"
  },
  "operatingAddress": {
    "streetLine1": "456 Office Ave",
    "streetLine2": "Suite 200",
    "city": "New York",
    "state": "NY",
    "postalCode": "10002",
    "country": "USA"
  }
}
RESPONSES
201Conta global aberta
{
  "id": "cus_2fvietuCNSu8unMNLsEGBrDTVFn",
  "businessLegalName": "Acme Corporation Inc."
}
400Payload inválido (validação DTO)
401Não autenticado
403Customer não vinculado ao contexto de autenticação

Headers esperados

  • Authorization: Bearer <jwt>
  • x-tenant-id: <tenant_id>
  • x-partner-id: <partner_id>
  • x-api-key: <api_key>

Observações

  • O valor de onboardingFlow deve ser obrigatoriamente direct.
  • country e os campos de endereço seguem ISO 3166-1 alpha-3 (ex.: USA, BRA).
  • Datas devem estar no formato YYYY-MM-DD.