Saltar al contenido 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/pendiente de confirmación"
}

Authorizations

​
Authorization
string
header
required

Autenticación con token JWT Bearer. Obtén el token desde el endpoint /v1/login/oauth/access_token usando credenciales de cliente (clientId y clientSecret).

Incluye el token en el encabezado Authorization: Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

El token expira después de 3600 segundos (1 hora).

Body

application/json
​
keyType
enum<integer>
required

Identificador del tipo de clave Pix. Códigos numéricos que especifican el tipo de clave Pix utilizada.

Valores válidos:

  • 0 = CPF (Identificación tributaria de persona física con 11 dígitos, p. ej., "12345678901")
  • 1 = CNPJ (Identificación tributaria de empresa con 14 dígitos, p. ej., "12345678000190")
  • 2 = EMAIL (Dirección de correo electrónico, p. ej., "user@example.com")
  • 3 = PHONE (Número telefónico en formato internacional, p. ej., "+5511987654321")
  • 4 = EVP (Clave aleatoria UUID generada automáticamente, p. ej., "123e4567-e89b-12d3-a456-426614174000")
Opciones disponibles:
0,
1,
2,
3,
4
Example:

3

​
accountId
string<uuid>
required

Identificador de la cuenta.

Example:

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

​
isValidated
boolean
required

Indica si la clave fue prevalidada (por ejemplo, correo/teléfono verificado).

Example:

false

​
key
string

Valor de la clave Pix (opcional para claves EVP/aleatorias que se generan automáticamente). El formato depende de keyType: CPF (11 dígitos), CNPJ (14 dígitos), correo electrónico (email válido), teléfono (prefijo +55) o se omite para EVP.

Example:

"+5511987654321"

Response

Clave Pix creada correctamente

​
key
string
required

Valor de la clave Pix.

Example:

"+5511987654321"

​
keyType
enum<integer>
required

Identificador del tipo de clave Pix. Códigos numéricos que especifican el tipo de clave Pix utilizada.

Valores válidos:

  • 0 = CPF (Identificación tributaria de persona física con 11 dígitos, p. ej., "12345678901")
  • 1 = CNPJ (Identificación tributaria de empresa con 14 dígitos, p. ej., "12345678000190")
  • 2 = EMAIL (Dirección de correo electrónico, p. ej., "user@example.com")
  • 3 = PHONE (Número telefónico en formato internacional, p. ej., "+5511987654321")
  • 4 = EVP (Clave aleatoria UUID generada automáticamente, p. ej., "123e4567-e89b-12d3-a456-426614174000")
Opciones disponibles:
0,
1,
2,
3,
4
Example:

3

​
status
enum<integer>
required

Código de estado del registro de la clave Pix. Indica el estado actual de una clave Pix en su ciclo de vida.

Valores válidos:

  • -1 = CANCELLED (El registro de la clave fue cancelado)
  • 0 = FINALIZED (La clave está finalizada/pendiente de confirmación)
  • 1 = ACTIVE (La clave está activa y operativa)
  • 2 = WAITING_OWNERSHIP_CONFIRMATION (En espera de la confirmación de titularidad por parte del usuario)
  • 3 = CREATING (La clave se está creando en el sistema)
  • 4 = IM_CLAIMER_PENDING_CONFIRM_CLAIM_REQUEST (Soy reclamante, pendiente de confirmación del reclamo)
  • 5 = IM_CLAIMER_PENDING_OWNER_GIVEWAY (Soy reclamante, esperando que el titular actual libere la clave)
  • 6 = IM_OWNER_PENDING_GIVEAWAY_CONFIRM (Soy titular, pendiente de aprobar la transferencia de la clave)
  • 7 = IM_CLAIMER_AND_OWNER_GAVEAWAY_PENDING_MY_CONFIRM (Transferencia iniciada, a la espera de mi confirmación)
Opciones disponibles:
-1,
0,
1,
2,
3,
4,
5,
6,
7
Example:

1

​
statusDescription
string
required

Descripción legible del estado que corresponde al código numérico.

Example:

"PENDING_CONFIRMATION"