Saltar al contenido principal
PUT
/
v1
/
entries
/
{entryId}
Cambiar una entrada de clave Pix
curl --request PUT \
  --url https://plugin-pix-direct.api.lerian.net/v1/entries/{entryId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "accountId": "<string>",
  "reason": 123,
  "accountOpeningDate": "<string>",
  "newAccount": "<string>",
  "newAccountType": 123,
  "newBranch": "<string>",
  "newName": "<string>",
  "newTradeName": "<string>"
}
'
import requests

url = "https://plugin-pix-direct.api.lerian.net/v1/entries/{entryId}"

payload = {
"accountId": "<string>",
"reason": 123,
"accountOpeningDate": "<string>",
"newAccount": "<string>",
"newAccountType": 123,
"newBranch": "<string>",
"newName": "<string>",
"newTradeName": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)
const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
accountId: '<string>',
reason: 123,
accountOpeningDate: '<string>',
newAccount: '<string>',
newAccountType: 123,
newBranch: '<string>',
newName: '<string>',
newTradeName: '<string>'
})
};

fetch('https://plugin-pix-direct.api.lerian.net/v1/entries/{entryId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://plugin-pix-direct.api.lerian.net/v1/entries/{entryId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'accountId' => '<string>',
'reason' => 123,
'accountOpeningDate' => '<string>',
'newAccount' => '<string>',
'newAccountType' => 123,
'newBranch' => '<string>',
'newName' => '<string>',
'newTradeName' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"strings"
"net/http"
"io"
)

func main() {

url := "https://plugin-pix-direct.api.lerian.net/v1/entries/{entryId}"

payload := strings.NewReader("{\n \"accountId\": \"<string>\",\n \"reason\": 123,\n \"accountOpeningDate\": \"<string>\",\n \"newAccount\": \"<string>\",\n \"newAccountType\": 123,\n \"newBranch\": \"<string>\",\n \"newName\": \"<string>\",\n \"newTradeName\": \"<string>\"\n}")

req, _ := http.NewRequest("PUT", url, payload)

req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.put("https://plugin-pix-direct.api.lerian.net/v1/entries/{entryId}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"accountId\": \"<string>\",\n \"reason\": 123,\n \"accountOpeningDate\": \"<string>\",\n \"newAccount\": \"<string>\",\n \"newAccountType\": 123,\n \"newBranch\": \"<string>\",\n \"newName\": \"<string>\",\n \"newTradeName\": \"<string>\"\n}")
.asString();
require 'uri'
require 'net/http'

url = URI("https://plugin-pix-direct.api.lerian.net/v1/entries/{entryId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"accountId\": \"<string>\",\n \"reason\": 123,\n \"accountOpeningDate\": \"<string>\",\n \"newAccount\": \"<string>\",\n \"newAccountType\": 123,\n \"newBranch\": \"<string>\",\n \"newName\": \"<string>\",\n \"newTradeName\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body
{
  "key": "<string>",
  "claimOpenedAt": "<string>",
  "createdAt": "<string>",
  "ownershipStartAt": "<string>"
}
{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "<string>",
"status": 123,
"title": "<string>",
"type": "about:blank"
}

Autorizaciones

Authorization
string
header
requerido

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).

Parámetros de ruta

entryId
string
requerido

El valor de la clave Pix (codificado en URL).

Cuerpo

application/json
accountId
string
requerido

El id de cuenta del CRM del titular de la clave (resuelve el ISPB del lado del servidor).

reason
integer<int64>
requerido

Motivo del cambio (0=Customer Request,2=Branch Transfer,6=Reconciliation,8=Receita Federal Validation). Las claves EVP no deben usar 0.

accountOpeningDate
string

La marca de tiempo de apertura de la nueva cuenta (RFC3339).

newAccount
string

El nuevo número de cuenta a asociar con la clave.

newAccountType
integer<int64>

El nuevo tipo de cuenta (0=Checking,1=Salary,2=Savings,3=Payment,4=PI).

newBranch
string

El nuevo número de agencia a asociar con la clave.

newName
string

El nombre completo / razón social del nuevo titular.

newTradeName
string

El nombre comercial del nuevo titular (se envía solo para un titular corporativo).

Respuesta

OK

key
string
requerido

La clave Pix (sin cambios).

claimOpenedAt
string

Cuándo el cambio abrió un reclamo de posesión/portabilidad (RFC3339), si lo hubo.

createdAt
string

Cuándo se creó la clave (RFC3339).

ownershipStartAt
string

Cuándo comenzó la titularidad de la clave (RFC3339).