Pular para o conteúdo principal
POST
/
v1
/
holders
/
{holder_id}
/
aliases
Criar uma Conta Alias
curl --request POST \
  --url https://crm.sandbox.lerian.net/v1/holders/{holder_id}/aliases \
  --header 'Content-Type: application/json' \
  --header 'X-Organization-id: <x-organization-id>' \
  --data '
{
  "ledgerId": "77b0fb8b-1bd9-4810-9c6d-7e80064fab0c",
  "accountId": "0194fa41-5333-77c7-91fe-309fb4618155",
  "bankingDetails": {
    "branch": "0001",
    "account": "123450",
    "type": "CACC",
    "openingDate": "2010-01-01",
    "iban": "US12345678901234567890",
    "countryCode": "US",
    "bankId": "12345"
  },
  "relatedParties": [
    {
      "document": "91315026015",
      "name": "John Doe",
      "role": "PRIMARY_HOLDER",
      "startDate": "2024-01-01"
    },
    {
      "document": "98765432100",
      "name": "Jane Doe",
      "role": "LEGAL_REPRESENTATIVE",
      "startDate": "2024-01-01",
      "endDate": "2025-12-31"
    }
  ],
  "regulatoryFields": {
    "participantDocument": "00000000000191"
  },
  "metadata": {
    "key": "value"
  }
}
'
{ "id": "01951ad1-9f62-793a-9095-fe7701f94434", "holderId": "0194f0ea-2cb2-78c9-b9be-704ba20a9cd8", "document": "08912345965", "ledgerId": "77b0fb8b-1bd9-4810-9c6d-7e80064fab0c", "accountId": "0194fa41-5333-77c7-91fe-309fb4618155", "bankingDetails": { "branch": "0001", "account": "123450", "type": "CACC", "openingDate": "2010-01-01", "iban": "US12345678901234567890", "countryCode": "US", "bankId": "12345" }, "relatedParties": [ { "id": "01951ad2-1234-5678-9abc-def012345678", "document": "91315026015", "name": "John Doe", "role": "PRIMARY_HOLDER", "startDate": "2024-01-01" }, { "id": "01951ad2-5678-9abc-def0-123456789abc", "document": "98765432100", "name": "Jane Doe", "role": "LEGAL_REPRESENTATIVE", "startDate": "2024-01-01", "endDate": "2025-12-31" } ], "regulatoryFields": { "participantDocument": "00000000000191" }, "metadata": { "key": "value" }, "createdAt": "2024-12-17T14:34:09.191705548Z", "updatedAt": "2024-12-17T14:34:09.191705648Z", "deletedAt": null }

Cabeçalhos

​
Authorization
string

O token de autorização no formato 'Bearer '.
Importante: Este header é obrigatório se o seu ambiente tiver o Access Manager habilitado. Para mais informações, consulte a documentação do Access Manager.

​
X-Organization-id
string
obrigatório

O identificador único da Organização associada à requisição.

Exemplo:

"01946120-0f45-7c5f-86a0-0ea7c59fdbd4"

Parâmetros de caminho

​
holder_id
string
obrigatório

Identificador único do Titular que será associado à Conta.

Corpo

application/json

Detalhes sobre a Conta Alias.

​
accountId
string
obrigatório

Identificador único da Conta do Midaz Ledger.

​
ledgerId
string
obrigatório

Identificador único do Midaz Ledger da conta relacionada.

​
bankingDetails
object

Detalhes da conta bancária do Titular.

​
relatedParties
object[]

Lista de partes relacionadas associadas a esta Conta Alias.

​
regulatoryFields
object

Campos de conformidade regulatória necessários para jurisdições específicas.

​
metadata
object

Um objeto contendo pares chave-valor para adicionar como metadata, onde o campo name é a chave e o campo value é o valor. Por exemplo, para adicionar um Centro de Custo, use 'costCenter': 'BR_11101997'.

Resposta

Indica que o recurso foi criado com sucesso e a operação foi concluída conforme esperado.

Informações sobre a Conta Alias.

​
id
string

Identificador único da Conta Alias.

​
holderId
string

Identificador único do Titular.

​
type
enum<string>

Tipo de Titular.

Opções disponíveis:
LEGAL_PERSON,
NATURAL_PERSON
​
document
string

Documento de identificação do Titular.

​
ledgerId
string

Identificador único do Midaz Ledger da Conta relacionada.

​
accountId
string

Identificador único da Conta relacionada.

​
bankingDetails
object

Detalhes da conta bancária do Titular.

​
relatedParties
object[]

Lista de partes relacionadas associadas a esta Conta Alias.

​
regulatoryFields
object

Campos de conformidade regulatória necessários para jurisdições específicas.

​
metadata
object

Um objeto contendo pares chave-valor para adicionar como metadata, onde o campo name é a chave e o campo value é o valor. Por exemplo, para adicionar um Centro de Custo, use 'costCenter': 'BR_11101997'.

​
createdAt
string

A data em que a Conta Alias foi criada.

​
updatedAt
string

A data em que a Conta Alias foi atualizada pela última vez.

​
deletedAt
string

A data em que a Conta Alias foi excluída.