Saltar al contenido principal
POST
/
v1
/
pix-automatico
/
schedules
/
inbound
/
validate
Validar una instrucción de pago entrante de Pix Automático
curl --request POST \
  --url https://plugin-pix-direct.api.lerian.net/v1/pix-automatico/schedules/inbound/validate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "dtVencimento": "<string>",
  "endToEndId": "<string>",
  "finalidadeAgendamento": 123,
  "idConciliacaoRecebedor": "<string>",
  "idRecorrencia": "<string>",
  "pagador": {
    "cpfCnpj": "<string>",
    "ispb": "<string>",
    "tpPessoa": 123
  },
  "recebedor": {
    "cnpj": "<string>",
    "ispb": "<string>",
    "nome": "<string>",
    "nrConta": "<string>",
    "tpConta": 123,
    "nrAgencia": "<string>"
  },
  "dtHrRecepcaoPspRecebedor": "<string>",
  "infEntreClientes": "<string>",
  "valor": 123
}
'
import requests

url = "https://plugin-pix-direct.api.lerian.net/v1/pix-automatico/schedules/inbound/validate"

payload = {
"dtVencimento": "<string>",
"endToEndId": "<string>",
"finalidadeAgendamento": 123,
"idConciliacaoRecebedor": "<string>",
"idRecorrencia": "<string>",
"pagador": {
"cpfCnpj": "<string>",
"ispb": "<string>",
"tpPessoa": 123
},
"recebedor": {
"cnpj": "<string>",
"ispb": "<string>",
"nome": "<string>",
"nrConta": "<string>",
"tpConta": 123,
"nrAgencia": "<string>"
},
"dtHrRecepcaoPspRecebedor": "<string>",
"infEntreClientes": "<string>",
"valor": 123
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}

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

print(response.text)
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
dtVencimento: '<string>',
endToEndId: '<string>',
finalidadeAgendamento: 123,
idConciliacaoRecebedor: '<string>',
idRecorrencia: '<string>',
pagador: {cpfCnpj: '<string>', ispb: '<string>', tpPessoa: 123},
recebedor: {
cnpj: '<string>',
ispb: '<string>',
nome: '<string>',
nrConta: '<string>',
tpConta: 123,
nrAgencia: '<string>'
},
dtHrRecepcaoPspRecebedor: '<string>',
infEntreClientes: '<string>',
valor: 123
})
};

fetch('https://plugin-pix-direct.api.lerian.net/v1/pix-automatico/schedules/inbound/validate', 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/pix-automatico/schedules/inbound/validate",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'dtVencimento' => '<string>',
'endToEndId' => '<string>',
'finalidadeAgendamento' => 123,
'idConciliacaoRecebedor' => '<string>',
'idRecorrencia' => '<string>',
'pagador' => [
'cpfCnpj' => '<string>',
'ispb' => '<string>',
'tpPessoa' => 123
],
'recebedor' => [
'cnpj' => '<string>',
'ispb' => '<string>',
'nome' => '<string>',
'nrConta' => '<string>',
'tpConta' => 123,
'nrAgencia' => '<string>'
],
'dtHrRecepcaoPspRecebedor' => '<string>',
'infEntreClientes' => '<string>',
'valor' => 123
]),
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/pix-automatico/schedules/inbound/validate"

payload := strings.NewReader("{\n \"dtVencimento\": \"<string>\",\n \"endToEndId\": \"<string>\",\n \"finalidadeAgendamento\": 123,\n \"idConciliacaoRecebedor\": \"<string>\",\n \"idRecorrencia\": \"<string>\",\n \"pagador\": {\n \"cpfCnpj\": \"<string>\",\n \"ispb\": \"<string>\",\n \"tpPessoa\": 123\n },\n \"recebedor\": {\n \"cnpj\": \"<string>\",\n \"ispb\": \"<string>\",\n \"nome\": \"<string>\",\n \"nrConta\": \"<string>\",\n \"tpConta\": 123,\n \"nrAgencia\": \"<string>\"\n },\n \"dtHrRecepcaoPspRecebedor\": \"<string>\",\n \"infEntreClientes\": \"<string>\",\n \"valor\": 123\n}")

req, _ := http.NewRequest("POST", 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.post("https://plugin-pix-direct.api.lerian.net/v1/pix-automatico/schedules/inbound/validate")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"dtVencimento\": \"<string>\",\n \"endToEndId\": \"<string>\",\n \"finalidadeAgendamento\": 123,\n \"idConciliacaoRecebedor\": \"<string>\",\n \"idRecorrencia\": \"<string>\",\n \"pagador\": {\n \"cpfCnpj\": \"<string>\",\n \"ispb\": \"<string>\",\n \"tpPessoa\": 123\n },\n \"recebedor\": {\n \"cnpj\": \"<string>\",\n \"ispb\": \"<string>\",\n \"nome\": \"<string>\",\n \"nrConta\": \"<string>\",\n \"tpConta\": 123,\n \"nrAgencia\": \"<string>\"\n },\n \"dtHrRecepcaoPspRecebedor\": \"<string>\",\n \"infEntreClientes\": \"<string>\",\n \"valor\": 123\n}")
.asString();
require 'uri'
require 'net/http'

url = URI("https://plugin-pix-direct.api.lerian.net/v1/pix-automatico/schedules/inbound/validate")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"dtVencimento\": \"<string>\",\n \"endToEndId\": \"<string>\",\n \"finalidadeAgendamento\": 123,\n \"idConciliacaoRecebedor\": \"<string>\",\n \"idRecorrencia\": \"<string>\",\n \"pagador\": {\n \"cpfCnpj\": \"<string>\",\n \"ispb\": \"<string>\",\n \"tpPessoa\": 123\n },\n \"recebedor\": {\n \"cnpj\": \"<string>\",\n \"ispb\": \"<string>\",\n \"nome\": \"<string>\",\n \"nrConta\": \"<string>\",\n \"tpConta\": 123,\n \"nrAgencia\": \"<string>\"\n },\n \"dtHrRecepcaoPspRecebedor\": \"<string>\",\n \"infEntreClientes\": \"<string>\",\n \"valor\": 123\n}"

response = http.request(request)
puts response.read_body
{
  "dtHrValidacao": "<string>",
  "resultado": 123,
  "motivoRejeicao": "<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).

Cuerpo

application/json
dtVencimento
string
requerido

Fecha de vencimiento del cobro recurrente (aaaa-mm-dd).

endToEndId
string
requerido

Id único de la instrucción de pago (32 caracteres).

finalidadeAgendamento
integer<int64>
requerido

Propósito de la programación (0=primero, 1=reintento posterior al vencimiento, 2=reenvío de liquidación).

idConciliacaoRecebedor
string
requerido

Id de conciliación del receptor (35 caracteres).

idRecorrencia
string
requerido

Id de recurrencia único (29 caracteres, RR...).

pagador
object
requerido
recebedor
object
requerido
devedor
object
dtHrRecepcaoPspRecebedor
string

Marca de tiempo de recepción del PSP receptor (UTC; obligatoria cuando finalidadeAgendamento=0).

infEntreClientes
string

Información del receptor al pagador de texto libre (140 caracteres).

valor
number<double>

Monto del pago recurrente en reales (un número JSON).

Respuesta

OK

dtHrValidacao
string
requerido

Marca de tiempo de la validación (UTC).

resultado
integer<int64>
requerido

Resultado de la validación (0=Invalido, 1=Valido).

motivoRejeicao
string

Código de motivo de rechazo (obligatorio cuando resultado=0).