Pular para o conteúdo principal
POST
/
v1
/
entries
curl --request POST \
  --url https://plugin-br-pix-direct-jd.sandbox.lerian.net/v1/entries \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "key": "+5511987654321",
  "keyType": 3,
  "accountId": "01989f9e-6508-79f8-9540-835be49fbd0d",
  "isValidated": false
}
'
{
  "key": "+5511987654321",
  "keyType": 3,
  "keyTypeDescription": "keyType 3 = PHONE",
  "status": 0,
  "statusDescription": "FINALIZED",
  "statusComment": "status 0 = FINALIZED/pending confirmation"
}

Autorizações

​
Authorization
string
header
obrigatório

Autenticacao por token JWT Bearer. Obtenha o token no endpoint /v1/login/oauth/access_token usando credenciais do cliente (clientId e clientSecret).

Inclua o token no header Authorization: Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

O token expira apos 3600 segundos (1 hora).

Corpo

application/json
​
keyType
enum<integer>
obrigatório

Identificador do tipo de chave PIX. Codigos numericos que especificam o tipo de chave PIX sendo utilizada.

Valores validos:

  • 0 = CPF (CPF de pessoa fisica com 11 digitos, ex.: "12345678901")
  • 1 = CNPJ (CNPJ de pessoa juridica com 14 digitos, ex.: "12345678000190")
  • 2 = EMAIL (Endereco de email, ex.: "user@example.com")
  • 3 = PHONE (Numero de telefone em formato internacional, ex.: "+5511987654321")
  • 4 = EVP (Chave UUID aleatoria gerada automaticamente, ex.: "123e4567-e89b-12d3-a456-426614174000")
Opções disponíveis:
0,
1,
2,
3,
4
Exemplo:

3

​
accountId
string<uuid>
obrigatório

Identificador da conta.

Exemplo:

"01989f9e-6508-79f8-9540-835be49fbd0d"

​
isValidated
boolean
obrigatório

Indica se a chave foi pre-validada (ex.: email/telefone verificado).

Exemplo:

false

​
key
string

Valor da chave PIX (opcional para chaves EVP/aleatorias que sao geradas automaticamente). O formato depende do keyType: CPF (11 digitos), CNPJ (14 digitos), Email (email valido), Telefone (prefixo +55) ou omitir para EVP.

Exemplo:

"+5511987654321"

Resposta

Chave PIX criada com sucesso

​
key
string
obrigatório

Valor da chave PIX.

Exemplo:

"+5511987654321"

​
keyType
enum<integer>
obrigatório

Identificador do tipo de chave PIX. Codigos numericos que especificam o tipo de chave PIX sendo utilizada.

Valores validos:

  • 0 = CPF (CPF de pessoa fisica com 11 digitos, ex.: "12345678901")
  • 1 = CNPJ (CNPJ de pessoa juridica com 14 digitos, ex.: "12345678000190")
  • 2 = EMAIL (Endereco de email, ex.: "user@example.com")
  • 3 = PHONE (Numero de telefone em formato internacional, ex.: "+5511987654321")
  • 4 = EVP (Chave UUID aleatoria gerada automaticamente, ex.: "123e4567-e89b-12d3-a456-426614174000")
Opções disponíveis:
0,
1,
2,
3,
4
Exemplo:

3

​
status
enum<integer>
obrigatório

Codigo de status de registro da chave PIX. Indica o estado atual de uma chave PIX em seu ciclo de vida.

Valores validos:

  • -1 = CANCELLED (Registro da chave foi cancelado)
  • 0 = FINALIZED (Chave finalizada/aguardando confirmacao)
  • 1 = ACTIVE (Chave ativa e operacional)
  • 2 = WAITING_OWNERSHIP_CONFIRMATION (Aguardando confirmacao de propriedade do usuario)
  • 3 = CREATING (Chave esta sendo criada no sistema)
  • 4 = IM_CLAIMER_PENDING_CONFIRM_CLAIM_REQUEST (Sou reivindicador, aguardando confirmacao da reivindicacao)
  • 5 = IM_CLAIMER_PENDING_OWNER_GIVEWAY (Sou reivindicador, aguardando proprietario atual liberar a chave)
  • 6 = IM_OWNER_PENDING_GIVEAWAY_CONFIRM (Sou proprietario, aguardando aprovacao para transferir a chave)
  • 7 = IM_CLAIMER_AND_OWNER_GAVEAWAY_PENDING_MY_CONFIRM (Transferencia iniciada, aguardando minha confirmacao)
Opções disponíveis:
-1,
0,
1,
2,
3,
4,
5,
6,
7
Exemplo:

1

​
statusDescription
string
obrigatório

Descricao legivel do status correspondente ao codigo de status numerico.

Exemplo:

"PENDING_CONFIRMATION"