> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Validar conta recebedora de forma síncrona > Valida uma conta recebedora de forma síncrona e retorna um envelope não-excepcional {resultado, motivo, motivoComplemento, dtHrValidacao} em todo desfecho (HTTP 200 mesmo para uma conta inválida). Executa as verificações de duplicata de 24h da conciliação + divergência do pagador, o tratamento especial do Bacen (ISPB 99999) e a verificação de consistência conta-documento. ## OpenAPI ````yaml pt/openapi/v3-current/pix.yaml POST /v1/webhooks/validates openapi: 3.0.3 info: title: Plugin BR Pix Direct - API Completa description: > API completa para o sistema de pagamentos instantaneos PIX brasileiro, incluindo operacoes de dicionario de chaves PIX, geracao/decodificacao de QR codes, transacoes e limites de transacao. version: 1.0.0 servers: - url: https://plugin-pix-direct.api.lerian.net - url: https://plugin-pix-direct-qrcode.api.lerian.net security: - bearerAuth: [] paths: /v1/webhooks/validates: post: tags: - Webhooks API summary: Validar conta recebedora de forma síncrona description: >- Valida uma conta recebedora de forma síncrona e retorna um envelope não-excepcional {resultado, motivo, motivoComplemento, dtHrValidacao} em todo desfecho (HTTP 200 mesmo para uma conta inválida). Executa as verificações de duplicata de 24h da conciliação + divergência do pagador, o tratamento especial do Bacen (ISPB 99999) e a verificação de consistência conta-documento. requestBody: content: application/json: schema: $ref: '#/components/schemas/ValidateAccountBody' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/ValidateAccountResponse' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Erro components: schemas: ValidateAccountBody: additionalProperties: false properties: bankIdPss: description: ISPB do participante PSS de Saque/troco (uma string v5.5.0). type: string creditoDevolucao: $ref: '#/components/schemas/ReturnCredit' creditoOrdemPagamento: $ref: '#/components/schemas/CreditMoneyOrder' dtHrOp: description: Data/hora da operação (ISO-8601). type: string finalidade: description: Finalidade (eFinality). format: int64 type: integer idConciliacaoRecebedor: description: Id de conciliação do recebedor. type: string infEntreClientes: description: Informação inter-clientes em texto livre. type: string modalidadeAgente: description: Modalidade do agente (eModalityAgent). format: int64 type: integer pagador: $ref: '#/components/schemas/PartyBlock' prioridadePagamento: description: Prioridade de pagamento. format: int64 type: integer recebedor: $ref: '#/components/schemas/PartyBlock' tpIniciacao: description: Tipo de iniciação (eStartupType). format: int64 type: integer tpPrioridadePagamento: description: Tipo de prioridade de pagamento. format: int64 type: integer valor: description: Valor em reais (um número JSON). format: double type: number vlrDetalhe: description: Entradas opcionais de detalhe de valor. items: $ref: '#/components/schemas/ValueDetailBlock' type: array nullable: true required: - pagador - recebedor - dtHrOp - valor type: object ValidateAccountResponse: additionalProperties: false properties: dtHrValidacao: description: Data/hora da validação (ISO-8601, UTC). type: string motivo: description: Código de motivo em um resultado inválido (BE17/AC03/BE01). type: string motivoComplemento: description: Rótulo legível do complemento de motivo em um resultado inválido. type: string resultado: description: Resultado da validação (0=Inválido, 1=Válido). format: int64 type: integer required: - resultado - dtHrValidacao type: object Detail: additionalProperties: false properties: code: description: >- Código de erro de domínio estável e legível por máquina, escopado ao serviço emissor (formato: -NNNN). type: string detail: description: Uma explicação legível específica desta ocorrência do problema. type: string errors: description: Lista opcional de detalhes individuais de erro items: $ref: '#/components/schemas/ErrorDetail' type: array nullable: true instance: description: >- Uma referência URI que identifica a ocorrência específica do problema. format: uri type: string status: description: Código de status HTTP format: int64 type: integer title: description: >- Um resumo curto e legível do tipo de problema. Este valor não deve mudar entre ocorrências do erro. type: string type: default: about:blank description: Uma referência URI para a documentação legível do erro. format: uri type: string type: object ReturnCredit: additionalProperties: false properties: codigoDevolucao: description: Código de motivo de retorno (eRefundCode). type: string endToEndIdDevolucao: description: Id ponta a ponta de retorno. type: string endToEndIdOriginal: description: Id ponta a ponta do CASH_OUT original. type: string type: object CreditMoneyOrder: additionalProperties: false properties: chave: description: A chave Pix. type: string endToEndId: description: Id ponta a ponta da ordem de pagamento. type: string idConciliacaoRecebedor: description: >- Id de conciliação do recebedor (a chave de verificação de duplicata de 24h). type: string type: object PartyBlock: additionalProperties: false properties: cpfCnpj: description: CPF/CNPJ do titular (uma string v5.5.0). type: string ispb: description: ISPB do participante (uma string v5.5.0). type: string nome: description: Nome do titular. type: string nrAgencia: description: Número da agência (a fonte da agência do participante). type: string nrConta: description: Número da conta (NUNCA usado como agência). type: string tpConta: description: 'Tipo de conta (eAccountType: 0=corrente).' format: int64 type: integer tpPessoa: description: 'Tipo de pessoa (ePersonType: 0=natural, 1=jurídica).' format: int64 type: integer required: - ispb - tpPessoa - cpfCnpj - nrAgencia - tpConta - nrConta - nome type: object ValueDetailBlock: additionalProperties: false properties: tipo: description: Tipo de detalhe de valor. format: int64 type: integer vlrTarifaDinheiroCompra: description: Valor da tarifa de compra à vista (reais). format: double type: number required: - vlrTarifaDinheiroCompra - tipo type: object ErrorDetail: additionalProperties: false properties: location: description: Onde o erro ocorreu, ex. 'body.items[3].tags' ou 'path.thing-id' type: string message: description: Texto da mensagem de erro type: string value: description: O valor no local informado type: object securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: > 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). ````