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
onboardingFlowdeve ser obrigatoriamentedirect. countrye os campos de endereço seguem ISO 3166-1 alpha-3 (ex.:USA,BRA).- Datas devem estar no formato
YYYY-MM-DD.